@kb-labs/agent-cli 0.5.0

package/README.md

@@ -0,0 +1,56 @@
+# @kb-labs/agent-cli
+
+CLI plugin for the KB Labs agent system. Provides the `agent:run` command and REST/WebSocket handlers for agent execution through the KB Labs platform.
+
+## Surfaces
+
+### CLI
+
+```bash
+# Execute a task
+pnpm kb agent:run --task="Add input validation to the login form"
+
+# Plan mode (analyze without executing)
+pnpm kb agent:run --task="Refactor auth module" --mode=plan
+
+# Edit mode (targeted file changes)
+pnpm kb agent:run --task="Fix types in auth.ts" --mode=edit --files=src/auth.ts
+
+# Debug mode (replay a trace)
+pnpm kb agent:run --mode=debug --trace=./trace.ndjson
+
+# Dry run
+pnpm kb agent:run --task="Add tests" --dry-run
+```
+
+### REST API
+
+Handlers registered as KB Labs plugin routes under `/api/v1/agents/*`.
+
+### WebSocket
+
+Real-time streaming of agent events (iterations, tool calls, completions) for Studio UI.
+
+## Flags
+
+| Flag | Type | Description |
+|------|------|-------------|
+| `--task` | string | Task description in natural language |
+| `--mode` | enum | `execute` (default), `plan`, `edit`, `debug` |
+| `--session-id` | string | Session ID (auto-generated if omitted) |
+| `--complexity` | enum | `simple`, `medium`, `complex` |
+| `--files` | string[] | Target files (edit mode) |
+| `--trace` | string | Trace file path (debug mode) |
+| `--dry-run` | boolean | Preview changes without applying |
+
+## Plugin Manifest
+
+Follows KB Labs V3 plugin manifest format. Exported from `src/manifest.ts` — declares commands, REST routes, WebSocket handlers, and permission requirements.
+
+## Dependencies
+
+- `@kb-labs/agent-core` — agent engine
+- `@kb-labs/agent-contracts` — shared types
+- `@kb-labs/agent-tools` — tool registry
+- `@kb-labs/agent-tracing` — trace loading for debug mode
+- `@kb-labs/sdk` — platform SDK

package/dist/cli/commands/diff.d.ts

@@ -0,0 +1,17 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+
+/**
+ * agent:diff - Show diff for specific file change
+ *
+ * Usage:
+ *   pnpm kb agent:diff --change-id={id}
+ *   pnpm kb agent:diff --change-id={id} --json
+ */
+type DiffInput = {
+    changeId?: string;
+    'change-id'?: string;
+    json?: boolean;
+};
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, DiffInput, unknown>;
+
+export { _default as default };

package/dist/cli/commands/diff.js

@@ -0,0 +1,182 @@
+import { defineCommand, useLogger } from '@kb-labs/sdk';
+import { promises } from 'fs';
+import path from 'path';
+
+// src/cli/commands/diff.ts
+var diff_default = defineCommand({
+  id: "diff",
+  description: "Show diff for specific file change",
+  handler: {
+    async execute(ctx, input) {
+      const logger = useLogger();
+      const flags = input.flags ?? input;
+      const changeId = flags["change-id"] ?? flags.changeId;
+      if (!changeId) {
+        const err = { success: false, error: "Missing required --change-id flag" };
+        ctx.ui.write(JSON.stringify(err, null, 2) + "\n");
+        return { exitCode: 1, response: err };
+      }
+      try {
+        const basePath = path.join(process.cwd(), ".kb", "agents", "sessions");
+        const sessions = await promises.readdir(basePath);
+        let snapshot = null;
+        let foundSessionId = null;
+        for (const sessionId of sessions) {
+          const snapshotPath = path.join(basePath, sessionId, "snapshots", `${changeId}.json`);
+          try {
+            const content = await promises.readFile(snapshotPath, "utf-8");
+            snapshot = JSON.parse(content);
+            foundSessionId = sessionId;
+            break;
+          } catch {
+            continue;
+          }
+        }
+        if (!snapshot) {
+          const err = { success: false, error: `Change not found: ${changeId}` };
+          ctx.ui.write(JSON.stringify(err, null, 2) + "\n");
+          return { exitCode: 1, response: err };
+        }
+        const diff = calculateDiff(snapshot);
+        const response = {
+          success: true,
+          changeId,
+          sessionId: foundSessionId,
+          data: {
+            ...snapshot,
+            diff
+          }
+        };
+        if (flags.json) {
+          ctx.ui.write(JSON.stringify(response, null, 2) + "\n");
+        } else {
+          printDiff(ctx, snapshot, diff);
+        }
+        return { exitCode: 0, response };
+      } catch (err) {
+        logger.error("agent:diff error:", err instanceof Error ? err : void 0);
+        const errResponse = {
+          success: false,
+          error: err instanceof Error ? err.message : String(err)
+        };
+        ctx.ui.write(JSON.stringify(errResponse, null, 2) + "\n");
+        return { exitCode: 1, response: errResponse };
+      }
+    }
+  }
+});
+function calculateDiff(snapshot) {
+  const beforeContent = snapshot.before?.content || "";
+  const afterContent = snapshot.after?.content || "";
+  const beforeLines = beforeContent.split("\n");
+  const afterLines = afterContent.split("\n");
+  const diff = {
+    additions: 0,
+    deletions: 0,
+    changes: []
+  };
+  const maxLines = Math.max(beforeLines.length, afterLines.length);
+  for (let i = 0; i < maxLines; i++) {
+    const before = beforeLines[i];
+    const after = afterLines[i];
+    if (before === void 0 && after !== void 0) {
+      diff.additions++;
+      diff.changes.push({
+        type: "add",
+        line: i + 1,
+        content: after
+      });
+    } else if (before !== void 0 && after === void 0) {
+      diff.deletions++;
+      diff.changes.push({
+        type: "delete",
+        line: i + 1,
+        content: before
+      });
+    } else if (before !== after) {
+      diff.deletions++;
+      diff.additions++;
+      diff.changes.push({
+        type: "change",
+        line: i + 1,
+        before,
+        after
+      });
+    }
+  }
+  return diff;
+}
+function printDiff(ctx, snapshot, diff) {
+  ctx.ui.write("\n");
+  ctx.ui.write("\u{1F4DD} File Change Diff\n");
+  ctx.ui.write("\n");
+  const timestamp = new Date(snapshot.timestamp).toLocaleString();
+  const operation = snapshot.operation.toUpperCase();
+  ctx.ui.write(`Change ID: ${snapshot.id}
+`);
+  ctx.ui.write(`File: ${snapshot.filePath}
+`);
+  ctx.ui.write(`Operation: ${operation}
+`);
+  ctx.ui.write(`Agent: ${snapshot.agentId}
+`);
+  ctx.ui.write(`Timestamp: ${timestamp}
+`);
+  ctx.ui.write("\n");
+  if (snapshot.metadata) {
+    if (snapshot.metadata.startLine !== void 0) {
+      ctx.ui.write(
+        `Patch: lines ${snapshot.metadata.startLine}-${snapshot.metadata.endLine}
+`
+      );
+    }
+    if (snapshot.metadata.linesAdded !== void 0) {
+      ctx.ui.write(
+        `Changes: +${snapshot.metadata.linesAdded} -${snapshot.metadata.linesRemoved}
+`
+      );
+    }
+    if (snapshot.metadata.isOverwrite) {
+      ctx.ui.write("Overwrote existing file\n");
+    }
+    ctx.ui.write("\n");
+  }
+  ctx.ui.write(`Summary: +${diff.additions} -${diff.deletions}
+`);
+  ctx.ui.write("\n");
+  ctx.ui.write("\u2500".repeat(60) + "\n");
+  if (snapshot.operation === "write" && !snapshot.before) {
+    ctx.ui.write("New file created:\n");
+    ctx.ui.write("\n");
+    const lines = snapshot.after.content.split("\n");
+    for (let i = 0; i < Math.min(lines.length, 50); i++) {
+      ctx.ui.write(`+ ${(i + 1).toString().padStart(4)} | ${lines[i]}
+`);
+    }
+    if (lines.length > 50) {
+      ctx.ui.write(`... (${lines.length - 50} more lines)
+`);
+    }
+  } else {
+    for (const change of diff.changes) {
+      if (change.type === "add") {
+        ctx.ui.write(`+ ${change.line.toString().padStart(4)} | ${change.content}
+`);
+      } else if (change.type === "delete") {
+        ctx.ui.write(`- ${change.line.toString().padStart(4)} | ${change.content}
+`);
+      } else if (change.type === "change") {
+        ctx.ui.write(`- ${change.line.toString().padStart(4)} | ${change.before}
+`);
+        ctx.ui.write(`+ ${change.line.toString().padStart(4)} | ${change.after}
+`);
+      }
+    }
+  }
+  ctx.ui.write("\u2500".repeat(60) + "\n");
+  ctx.ui.write("\n");
+}
+
+export { diff_default as default };
+//# sourceMappingURL=diff.js.map
+//# sourceMappingURL=diff.js.map

package/dist/cli/commands/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/commands/diff.ts"],"names":["fs"],"mappings":"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","file":"diff.js","sourcesContent":["/**\n * agent:diff - Show diff for specific file change\n *\n * Usage:\n *   pnpm kb agent:diff --change-id={id}\n *   pnpm kb agent:diff --change-id={id} --json\n */\n\nimport { defineCommand, useLogger } from '@kb-labs/sdk';\nimport type { PluginContextV3 } from '@kb-labs/sdk';\nimport { promises as fs } from 'fs';\nimport path from 'path';\n\ntype DiffInput = {\n  changeId?: string;\n  'change-id'?: string;\n  json?: boolean;\n};\n\ntype DiffResult = { exitCode: number; response?: any };\n\nexport default defineCommand({\n  id: 'diff',\n  description: 'Show diff for specific file change',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: DiffInput): Promise<DiffResult> {\n      const logger = useLogger();\n      const flags = (input as any).flags ?? input;\n\n      const changeId = flags['change-id'] ?? flags.changeId;\n      if (!changeId) {\n        const err = { success: false, error: 'Missing required --change-id flag' };\n        ctx.ui.write(JSON.stringify(err, null, 2) + '\\n');\n        return { exitCode: 1, response: err };\n      }\n\n      try {\n        const basePath = path.join(process.cwd(), '.kb', 'agents', 'sessions');\n\n        // Search all sessions for this change ID\n        const sessions = await fs.readdir(basePath);\n        let snapshot = null;\n        let foundSessionId = null;\n\n        for (const sessionId of sessions) {\n          const snapshotPath = path.join(basePath, sessionId, 'snapshots', `${changeId}.json`);\n\n          try {\n            const content = await fs.readFile(snapshotPath, 'utf-8');\n            snapshot = JSON.parse(content);\n            foundSessionId = sessionId;\n            break;\n          } catch {\n            // Try next session\n            continue;\n          }\n        }\n\n        if (!snapshot) {\n          const err = { success: false, error: `Change not found: ${changeId}` };\n          ctx.ui.write(JSON.stringify(err, null, 2) + '\\n');\n          return { exitCode: 1, response: err };\n        }\n\n        // Calculate diff\n        const diff = calculateDiff(snapshot);\n\n        const response = {\n          success: true,\n          changeId,\n          sessionId: foundSessionId,\n          data: {\n            ...snapshot,\n            diff,\n          },\n        };\n\n        if (flags.json) {\n          ctx.ui.write(JSON.stringify(response, null, 2) + '\\n');\n        } else {\n          printDiff(ctx, snapshot, diff);\n        }\n\n        return { exitCode: 0, response };\n      } catch (err) {\n        logger.error('agent:diff error:', err instanceof Error ? err : undefined);\n        const errResponse = {\n          success: false,\n          error: err instanceof Error ? err.message : String(err),\n        };\n        ctx.ui.write(JSON.stringify(errResponse, null, 2) + '\\n');\n        return { exitCode: 1, response: errResponse };\n      }\n    },\n  },\n});\n\n/**\n * Calculate line-by-line diff\n */\nfunction calculateDiff(snapshot: any): any {\n  const beforeContent = snapshot.before?.content || '';\n  const afterContent = snapshot.after?.content || '';\n\n  const beforeLines = beforeContent.split('\\n');\n  const afterLines = afterContent.split('\\n');\n\n  const diff = {\n    additions: 0,\n    deletions: 0,\n    changes: [] as any[],\n  };\n\n  // Simple line-by-line comparison\n  const maxLines = Math.max(beforeLines.length, afterLines.length);\n\n  for (let i = 0; i < maxLines; i++) {\n    const before = beforeLines[i];\n    const after = afterLines[i];\n\n    if (before === undefined && after !== undefined) {\n      // Line added\n      diff.additions++;\n      diff.changes.push({\n        type: 'add',\n        line: i + 1,\n        content: after,\n      });\n    } else if (before !== undefined && after === undefined) {\n      // Line deleted\n      diff.deletions++;\n      diff.changes.push({\n        type: 'delete',\n        line: i + 1,\n        content: before,\n      });\n    } else if (before !== after) {\n      // Line changed\n      diff.deletions++;\n      diff.additions++;\n      diff.changes.push({\n        type: 'change',\n        line: i + 1,\n        before,\n        after,\n      });\n    }\n  }\n\n  return diff;\n}\n\n/**\n * Print diff in human-readable format\n */\nfunction printDiff(ctx: PluginContextV3, snapshot: any, diff: any): void {\n  ctx.ui.write('\\n');\n  ctx.ui.write('📝 File Change Diff\\n');\n  ctx.ui.write('\\n');\n\n  const timestamp = new Date(snapshot.timestamp).toLocaleString();\n  const operation = snapshot.operation.toUpperCase();\n\n  ctx.ui.write(`Change ID: ${snapshot.id}\\n`);\n  ctx.ui.write(`File: ${snapshot.filePath}\\n`);\n  ctx.ui.write(`Operation: ${operation}\\n`);\n  ctx.ui.write(`Agent: ${snapshot.agentId}\\n`);\n  ctx.ui.write(`Timestamp: ${timestamp}\\n`);\n  ctx.ui.write('\\n');\n\n  if (snapshot.metadata) {\n    if (snapshot.metadata.startLine !== undefined) {\n      ctx.ui.write(\n        `Patch: lines ${snapshot.metadata.startLine}-${snapshot.metadata.endLine}\\n`\n      );\n    }\n    if (snapshot.metadata.linesAdded !== undefined) {\n      ctx.ui.write(\n        `Changes: +${snapshot.metadata.linesAdded} -${snapshot.metadata.linesRemoved}\\n`\n      );\n    }\n    if (snapshot.metadata.isOverwrite) {\n      ctx.ui.write('Overwrote existing file\\n');\n    }\n    ctx.ui.write('\\n');\n  }\n\n  ctx.ui.write(`Summary: +${diff.additions} -${diff.deletions}\\n`);\n  ctx.ui.write('\\n');\n\n  // Print diff\n  ctx.ui.write('─'.repeat(60) + '\\n');\n\n  if (snapshot.operation === 'write' && !snapshot.before) {\n    // New file - show full content\n    ctx.ui.write('New file created:\\n');\n    ctx.ui.write('\\n');\n    const lines = snapshot.after.content.split('\\n');\n    for (let i = 0; i < Math.min(lines.length, 50); i++) {\n      ctx.ui.write(`+ ${(i + 1).toString().padStart(4)} | ${lines[i]}\\n`);\n    }\n    if (lines.length > 50) {\n      ctx.ui.write(`... (${lines.length - 50} more lines)\\n`);\n    }\n  } else {\n    // Show diff\n    for (const change of diff.changes) {\n      if (change.type === 'add') {\n        ctx.ui.write(`+ ${change.line.toString().padStart(4)} | ${change.content}\\n`);\n      } else if (change.type === 'delete') {\n        ctx.ui.write(`- ${change.line.toString().padStart(4)} | ${change.content}\\n`);\n      } else if (change.type === 'change') {\n        ctx.ui.write(`- ${change.line.toString().padStart(4)} | ${change.before}\\n`);\n        ctx.ui.write(`+ ${change.line.toString().padStart(4)} | ${change.after}\\n`);\n      }\n    }\n  }\n\n  ctx.ui.write('─'.repeat(60) + '\\n');\n  ctx.ui.write('\\n');\n}\n"]}

package/dist/cli/commands/history.d.ts

@@ -0,0 +1,16 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+
+/**
+ * agent:history - Show file change history for agent sessions
+ */
+type HistoryInput = {
+    sessionId?: string;
+    'session-id'?: string;
+    file?: string;
+    agentId?: string;
+    'agent-id'?: string;
+    json?: boolean;
+};
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, HistoryInput, unknown>;
+
+export { _default as default };

package/dist/cli/commands/history.js

@@ -0,0 +1,216 @@
+import { defineCommand } from '@kb-labs/sdk';
+import { SessionManager } from '@kb-labs/agent-core';
+
+// src/cli/commands/history.ts
+var history_default = defineCommand({
+  id: "history",
+  description: "Show file change history for agent sessions",
+  handler: {
+    async execute(ctx, input) {
+      const flags = input.flags ?? input;
+      const manager = new SessionManager(process.cwd());
+      try {
+        const sessionId = flags["session-id"] ?? flags.sessionId;
+        const agentId = flags["agent-id"] ?? flags.agentId;
+        if (sessionId) {
+          return showSessionHistory(ctx, manager, String(sessionId), Boolean(flags.json));
+        }
+        if (flags.file) {
+          return showFileHistory(ctx, manager, String(flags.file), Boolean(flags.json));
+        }
+        if (agentId) {
+          return showAgentHistory(ctx, manager, String(agentId), Boolean(flags.json));
+        }
+        return listAllSessions(ctx, manager, Boolean(flags.json));
+      } catch (error) {
+        const response = {
+          success: false,
+          error: error instanceof Error ? error.message : String(error)
+        };
+        ctx.ui.write(JSON.stringify(response, null, 2) + "\n");
+        return { exitCode: 1, response };
+      }
+    }
+  }
+});
+async function showSessionHistory(ctx, manager, sessionId, asJson) {
+  const info = await manager.getSessionInfo(sessionId);
+  if (!info) {
+    const err = { success: false, error: `Session not found: ${sessionId}` };
+    ctx.ui.write(JSON.stringify(err, null, 2) + "\n");
+    return { exitCode: 1, response: err };
+  }
+  const turns = await manager.getTurns(sessionId);
+  const changes = collectChanges(sessionId, turns);
+  changes.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+  const response = {
+    success: true,
+    sessionId,
+    runCount: info.runCount,
+    changes: changes.length,
+    data: changes
+  };
+  if (asJson) {
+    ctx.ui.write(JSON.stringify(response, null, 2) + "\n");
+  } else {
+    ctx.ui.write(`Session: ${sessionId}
+`);
+    ctx.ui.write(`Runs: ${info.runCount} | Changes: ${changes.length}
+
+`);
+    for (const c of changes) {
+      const ts = new Date(c.timestamp).toLocaleString();
+      ctx.ui.write(`[${ts}] ${c.operation.toUpperCase()} ${c.filePath}
+`);
+      ctx.ui.write(`  Agent: ${c.agentId} | Turn: #${c.turnSequence}
+`);
+      ctx.ui.write(`  Change ID: ${c.changeId}
+
+`);
+    }
+  }
+  return { exitCode: 0, response };
+}
+async function showFileHistory(ctx, manager, filePath, asJson) {
+  const sessions = await manager.listSessions({ limit: 1e3, offset: 0 });
+  const allChanges = [];
+  for (const s of sessions.sessions) {
+    const turns = await manager.getTurns(s.id);
+    const changes = collectChanges(s.id, turns).filter((c) => c.filePath === filePath);
+    allChanges.push(...changes);
+  }
+  allChanges.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+  const response = {
+    success: true,
+    filePath,
+    changes: allChanges.length,
+    data: allChanges
+  };
+  if (asJson) {
+    ctx.ui.write(JSON.stringify(response, null, 2) + "\n");
+  } else {
+    ctx.ui.write(`File: ${filePath}
+`);
+    ctx.ui.write(`Changes: ${allChanges.length}
+
+`);
+    for (const c of allChanges) {
+      const ts = new Date(c.timestamp).toLocaleString();
+      ctx.ui.write(`[${ts}] ${c.operation.toUpperCase()} (${c.sessionId})
+`);
+      ctx.ui.write(`  Agent: ${c.agentId} | Change ID: ${c.changeId}
+
+`);
+    }
+  }
+  return { exitCode: 0, response };
+}
+async function showAgentHistory(ctx, manager, agentId, asJson) {
+  const sessions = await manager.listSessions({ limit: 1e3, offset: 0 });
+  const allChanges = [];
+  for (const s of sessions.sessions) {
+    const turns = await manager.getTurns(s.id);
+    const changes = collectChanges(s.id, turns).filter((c) => c.agentId === agentId);
+    allChanges.push(...changes);
+  }
+  allChanges.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+  const response = {
+    success: true,
+    agentId,
+    changes: allChanges.length,
+    data: allChanges
+  };
+  if (asJson) {
+    ctx.ui.write(JSON.stringify(response, null, 2) + "\n");
+  } else {
+    ctx.ui.write(`Agent: ${agentId}
+`);
+    ctx.ui.write(`Changes: ${allChanges.length}
+
+`);
+    for (const c of allChanges) {
+      const ts = new Date(c.timestamp).toLocaleString();
+      ctx.ui.write(`[${ts}] ${c.operation.toUpperCase()} ${c.filePath} (${c.sessionId})
+`);
+    }
+    ctx.ui.write("\n");
+  }
+  return { exitCode: 0, response };
+}
+async function listAllSessions(ctx, manager, asJson) {
+  const sessions = await manager.listSessions({ limit: 1e3, offset: 0 });
+  const uniqueSessions = dedupeSessionsById(sessions.sessions);
+  const data = await Promise.all(
+    uniqueSessions.map(async (s) => {
+      const turns = await manager.getTurns(s.id);
+      return {
+        sessionId: s.id,
+        status: s.status,
+        runCount: s.runCount,
+        lastActivityAt: s.lastActivityAt,
+        changes: collectChanges(s.id, turns).length
+      };
+    })
+  );
+  const response = {
+    success: true,
+    sessions: data.length,
+    data
+  };
+  if (asJson) {
+    ctx.ui.write(JSON.stringify(response, null, 2) + "\n");
+  } else {
+    ctx.ui.write(`Sessions: ${data.length}
+
+`);
+    for (const s of data) {
+      ctx.ui.write(`${s.sessionId}
+`);
+      ctx.ui.write(`  Runs: ${s.runCount} | Changes: ${s.changes} | Status: ${s.status}
+`);
+      ctx.ui.write(`  Last activity: ${new Date(s.lastActivityAt).toLocaleString()}
+
+`);
+    }
+  }
+  return { exitCode: 0, response };
+}
+function dedupeSessionsById(sessions) {
+  const byId = /* @__PURE__ */ new Map();
+  for (const session of sessions) {
+    const existing = byId.get(session.id);
+    if (!existing) {
+      byId.set(session.id, session);
+      continue;
+    }
+    const existingTs = Date.parse(existing.lastActivityAt);
+    const incomingTs = Date.parse(session.lastActivityAt);
+    if (incomingTs > existingTs || incomingTs === existingTs && session.runCount > existing.runCount) {
+      byId.set(session.id, session);
+    }
+  }
+  return Array.from(byId.values()).sort((a, b) => Date.parse(b.lastActivityAt) - Date.parse(a.lastActivityAt));
+}
+function collectChanges(sessionId, turns) {
+  const rows = [];
+  for (const turn of turns) {
+    if (turn.type !== "assistant") {
+      continue;
+    }
+    const changes = turn.metadata.fileChanges ?? [];
+    for (const change of changes) {
+      rows.push({
+        ...change,
+        sessionId,
+        turnId: turn.id,
+        turnSequence: turn.sequence,
+        agentId: turn.metadata.agentId
+      });
+    }
+  }
+  return rows;
+}
+
+export { history_default as default };
+//# sourceMappingURL=history.js.map
+//# sourceMappingURL=history.js.map

package/dist/cli/commands/history.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/cli/commands/history.ts"],"names":[],"mappings":"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","file":"history.js","sourcesContent":["/**\n * agent:history - Show file change history for agent sessions\n */\n\nimport { defineCommand, type PluginContextV3 } from '@kb-labs/sdk';\nimport { SessionManager } from '@kb-labs/agent-core';\nimport type { FileChangeSummary, Turn } from '@kb-labs/agent-contracts';\n\ntype HistoryInput = {\n  sessionId?: string;\n  'session-id'?: string;\n  file?: string;\n  agentId?: string;\n  'agent-id'?: string;\n  json?: boolean;\n};\n\ntype HistoryResult = { exitCode: number; response?: unknown };\n\ntype ChangeRow = FileChangeSummary & {\n  sessionId: string;\n  turnId: string;\n  turnSequence: number;\n  agentId: string;\n};\n\nexport default defineCommand({\n  id: 'history',\n  description: 'Show file change history for agent sessions',\n\n  handler: {\n    async execute(ctx: PluginContextV3, input: HistoryInput): Promise<HistoryResult> {\n      const flags = (input as any).flags ?? input;\n      const manager = new SessionManager(process.cwd());\n\n      try {\n        const sessionId = flags['session-id'] ?? flags.sessionId;\n        const agentId = flags['agent-id'] ?? flags.agentId;\n        if (sessionId) {\n          return showSessionHistory(ctx, manager, String(sessionId), Boolean(flags.json));\n        }\n        if (flags.file) {\n          return showFileHistory(ctx, manager, String(flags.file), Boolean(flags.json));\n        }\n        if (agentId) {\n          return showAgentHistory(ctx, manager, String(agentId), Boolean(flags.json));\n        }\n        return listAllSessions(ctx, manager, Boolean(flags.json));\n      } catch (error) {\n        const response = {\n          success: false,\n          error: error instanceof Error ? error.message : String(error),\n        };\n        ctx.ui.write(JSON.stringify(response, null, 2) + '\\n');\n        return { exitCode: 1, response };\n      }\n    },\n  },\n});\n\nasync function showSessionHistory(\n  ctx: PluginContextV3,\n  manager: SessionManager,\n  sessionId: string,\n  asJson: boolean\n): Promise<HistoryResult> {\n  const info = await manager.getSessionInfo(sessionId);\n  if (!info) {\n    const err = { success: false, error: `Session not found: ${sessionId}` };\n    ctx.ui.write(JSON.stringify(err, null, 2) + '\\n');\n    return { exitCode: 1, response: err };\n  }\n\n  const turns = await manager.getTurns(sessionId);\n  const changes = collectChanges(sessionId, turns);\n  changes.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());\n\n  const response = {\n    success: true,\n    sessionId,\n    runCount: info.runCount,\n    changes: changes.length,\n    data: changes,\n  };\n\n  if (asJson) {\n    ctx.ui.write(JSON.stringify(response, null, 2) + '\\n');\n  } else {\n    ctx.ui.write(`Session: ${sessionId}\\n`);\n    ctx.ui.write(`Runs: ${info.runCount} | Changes: ${changes.length}\\n\\n`);\n    for (const c of changes) {\n      const ts = new Date(c.timestamp).toLocaleString();\n      ctx.ui.write(`[${ts}] ${c.operation.toUpperCase()} ${c.filePath}\\n`);\n      ctx.ui.write(`  Agent: ${c.agentId} | Turn: #${c.turnSequence}\\n`);\n      ctx.ui.write(`  Change ID: ${c.changeId}\\n\\n`);\n    }\n  }\n\n  return { exitCode: 0, response };\n}\n\nasync function showFileHistory(\n  ctx: PluginContextV3,\n  manager: SessionManager,\n  filePath: string,\n  asJson: boolean\n): Promise<HistoryResult> {\n  const sessions = await manager.listSessions({ limit: 1000, offset: 0 });\n  const allChanges: ChangeRow[] = [];\n\n  for (const s of sessions.sessions) {\n    const turns = await manager.getTurns(s.id);\n    const changes = collectChanges(s.id, turns).filter((c) => c.filePath === filePath);\n    allChanges.push(...changes);\n  }\n\n  allChanges.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());\n  const response = {\n    success: true,\n    filePath,\n    changes: allChanges.length,\n    data: allChanges,\n  };\n\n  if (asJson) {\n    ctx.ui.write(JSON.stringify(response, null, 2) + '\\n');\n  } else {\n    ctx.ui.write(`File: ${filePath}\\n`);\n    ctx.ui.write(`Changes: ${allChanges.length}\\n\\n`);\n    for (const c of allChanges) {\n      const ts = new Date(c.timestamp).toLocaleString();\n      ctx.ui.write(`[${ts}] ${c.operation.toUpperCase()} (${c.sessionId})\\n`);\n      ctx.ui.write(`  Agent: ${c.agentId} | Change ID: ${c.changeId}\\n\\n`);\n    }\n  }\n\n  return { exitCode: 0, response };\n}\n\nasync function showAgentHistory(\n  ctx: PluginContextV3,\n  manager: SessionManager,\n  agentId: string,\n  asJson: boolean\n): Promise<HistoryResult> {\n  const sessions = await manager.listSessions({ limit: 1000, offset: 0 });\n  const allChanges: ChangeRow[] = [];\n\n  for (const s of sessions.sessions) {\n    const turns = await manager.getTurns(s.id);\n    const changes = collectChanges(s.id, turns).filter((c) => c.agentId === agentId);\n    allChanges.push(...changes);\n  }\n\n  allChanges.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());\n  const response = {\n    success: true,\n    agentId,\n    changes: allChanges.length,\n    data: allChanges,\n  };\n\n  if (asJson) {\n    ctx.ui.write(JSON.stringify(response, null, 2) + '\\n');\n  } else {\n    ctx.ui.write(`Agent: ${agentId}\\n`);\n    ctx.ui.write(`Changes: ${allChanges.length}\\n\\n`);\n    for (const c of allChanges) {\n      const ts = new Date(c.timestamp).toLocaleString();\n      ctx.ui.write(`[${ts}] ${c.operation.toUpperCase()} ${c.filePath} (${c.sessionId})\\n`);\n    }\n    ctx.ui.write('\\n');\n  }\n\n  return { exitCode: 0, response };\n}\n\nasync function listAllSessions(\n  ctx: PluginContextV3,\n  manager: SessionManager,\n  asJson: boolean\n): Promise<HistoryResult> {\n  const sessions = await manager.listSessions({ limit: 1000, offset: 0 });\n  const uniqueSessions = dedupeSessionsById(sessions.sessions);\n  const data = await Promise.all(\n    uniqueSessions.map(async (s) => {\n      const turns = await manager.getTurns(s.id);\n      return {\n        sessionId: s.id,\n        status: s.status,\n        runCount: s.runCount,\n        lastActivityAt: s.lastActivityAt,\n        changes: collectChanges(s.id, turns).length,\n      };\n    }),\n  );\n\n  const response = {\n    success: true,\n    sessions: data.length,\n    data,\n  };\n\n  if (asJson) {\n    ctx.ui.write(JSON.stringify(response, null, 2) + '\\n');\n  } else {\n    ctx.ui.write(`Sessions: ${data.length}\\n\\n`);\n    for (const s of data) {\n      ctx.ui.write(`${s.sessionId}\\n`);\n      ctx.ui.write(`  Runs: ${s.runCount} | Changes: ${s.changes} | Status: ${s.status}\\n`);\n      ctx.ui.write(`  Last activity: ${new Date(s.lastActivityAt).toLocaleString()}\\n\\n`);\n    }\n  }\n\n  return { exitCode: 0, response };\n}\n\nfunction dedupeSessionsById<T extends { id: string; status?: string; runCount: number; lastActivityAt: string }>(sessions: T[]): T[] {\n  const byId = new Map<string, T>();\n  for (const session of sessions) {\n    const existing = byId.get(session.id);\n    if (!existing) {\n      byId.set(session.id, session);\n      continue;\n    }\n\n    const existingTs = Date.parse(existing.lastActivityAt);\n    const incomingTs = Date.parse(session.lastActivityAt);\n    if (incomingTs > existingTs || (incomingTs === existingTs && session.runCount > existing.runCount)) {\n      byId.set(session.id, session);\n    }\n  }\n  return Array.from(byId.values()).sort((a, b) => Date.parse(b.lastActivityAt) - Date.parse(a.lastActivityAt));\n}\n\nfunction collectChanges(sessionId: string, turns: Turn[]): ChangeRow[] {\n  const rows: ChangeRow[] = [];\n  for (const turn of turns) {\n    if (turn.type !== 'assistant') {\n      continue;\n    }\n    const changes = turn.metadata.fileChanges ?? [];\n    for (const change of changes) {\n      rows.push({\n        ...change,\n        sessionId,\n        turnId: turn.id,\n        turnSequence: turn.sequence,\n        agentId: turn.metadata.agentId,\n      });\n    }\n  }\n  return rows;\n}\n"]}

package/dist/cli/commands/quality-report.d.ts

@@ -0,0 +1,21 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+
+/**
+ * agent:quality:report - Agent execution quality control report
+ *
+ * Usage:
+ *   pnpm kb agent quality report
+ *   pnpm kb agent quality report --days=3
+ *   pnpm kb agent quality report --session-id=session-123
+ *   pnpm kb agent quality report --json
+ */
+type QualityReportInput = {
+    days?: number;
+    limit?: number;
+    sessionId?: string;
+    'session-id'?: string;
+    json?: boolean;
+};
+declare const _default: _kb_labs_shared_command_kit.CommandHandlerV3<unknown, QualityReportInput, unknown>;
+
+export { _default as default };