@kb-labs/agent-cli 0.5.0

package/dist/rest/handlers/get-session-handler.d.ts

@@ -0,0 +1,10 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { RestInput } from '@kb-labs/sdk';
+import { GetSessionResponse } from '@kb-labs/agent-contracts';
+
+interface GetSessionRequest {
+    sessionId?: string;
+}
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, RestInput<GetSessionRequest, unknown, unknown>, GetSessionResponse>;
+
+export { _default as default };

package/dist/rest/handlers/get-session-handler.js

@@ -0,0 +1,23 @@
+import { defineHandler } from '@kb-labs/sdk';
+import { SessionManager } from '@kb-labs/agent-core';
+
+// src/rest/handlers/get-session-handler.ts
+var get_session_handler_default = defineHandler({
+  async execute(ctx, input) {
+    const params = input.params;
+    const sessionId = params?.sessionId;
+    if (!sessionId) {
+      throw new Error("Session ID is required");
+    }
+    const sessionManager = new SessionManager(ctx.cwd);
+    const session = await sessionManager.getSessionInfo(sessionId);
+    if (!session) {
+      throw new Error(`Session not found: ${sessionId}`);
+    }
+    return { session };
+  }
+});
+
+export { get_session_handler_default as default };
+//# sourceMappingURL=get-session-handler.js.map
+//# sourceMappingURL=get-session-handler.js.map

package/dist/rest/handlers/get-session-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/rest/handlers/get-session-handler.ts"],"names":[],"mappings":";;;;AAYA,IAAO,8BAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,OAAA,CACJ,GAAA,EACA,KAAA,EAC6B;AAC7B,IAAA,MAAM,SAAS,KAAA,CAAM,MAAA;AACrB,IAAA,MAAM,YAAY,MAAA,EAAQ,SAAA;AAE1B,IAAA,IAAI,CAAC,SAAA,EAAW;AACd,MAAA,MAAM,IAAI,MAAM,wBAAwB,CAAA;AAAA,IAC1C;AAEA,IAAA,MAAM,cAAA,GAAiB,IAAI,cAAA,CAAe,GAAA,CAAI,GAAG,CAAA;AACjD,IAAA,MAAM,OAAA,GAAU,MAAM,cAAA,CAAe,cAAA,CAAe,SAAS,CAAA;AAE7D,IAAA,IAAI,CAAC,OAAA,EAAS;AACZ,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,mBAAA,EAAsB,SAAS,CAAA,CAAE,CAAA;AAAA,IACnD;AAEA,IAAA,OAAO,EAAE,OAAA,EAAQ;AAAA,EACnB;AACF,CAAC","file":"get-session-handler.js","sourcesContent":["/**\n * GET /sessions/:sessionId - Get session details\n */\n\nimport { defineHandler, type RestInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport { SessionManager } from '@kb-labs/agent-core';\nimport type { GetSessionResponse } from '@kb-labs/agent-contracts';\n\ninterface GetSessionRequest {\n  sessionId?: string;\n}\n\nexport default defineHandler({\n  async execute(\n    ctx: PluginContextV3,\n    input: RestInput<GetSessionRequest>\n  ): Promise<GetSessionResponse> {\n    const params = input.params as Record<string, string> | undefined;\n    const sessionId = params?.sessionId;\n\n    if (!sessionId) {\n      throw new Error('Session ID is required');\n    }\n\n    const sessionManager = new SessionManager(ctx.cwd);\n    const session = await sessionManager.getSessionInfo(sessionId);\n\n    if (!session) {\n      throw new Error(`Session not found: ${sessionId}`);\n    }\n\n    return { session };\n  },\n});\n"]}

package/dist/rest/handlers/get-session-plan-handler.d.ts

@@ -0,0 +1,10 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { RestInput } from '@kb-labs/sdk';
+import { GetSessionPlanResponse } from '@kb-labs/agent-contracts';
+
+interface GetSessionPlanRequest {
+    sessionId?: string;
+}
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, RestInput<GetSessionPlanRequest, unknown, unknown>, GetSessionPlanResponse>;
+
+export { _default as default };

package/dist/rest/handlers/get-session-plan-handler.js

@@ -0,0 +1,53 @@
+import { defineHandler } from '@kb-labs/sdk';
+import { SessionManager, PlanDocumentService } from '@kb-labs/agent-core';
+import { promises } from 'fs';
+
+// src/rest/handlers/get-session-plan-handler.ts
+async function loadPlan(planPath) {
+  try {
+    const content = await promises.readFile(planPath, "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
+async function pathExists(filePath) {
+  try {
+    await promises.access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+var get_session_plan_handler_default = defineHandler({
+  async execute(ctx, input) {
+    const params = input.params;
+    const sessionId = params?.sessionId;
+    if (!sessionId) {
+      throw new Error("Session ID is required");
+    }
+    const sessionManager = new SessionManager(ctx.cwd);
+    const session = await sessionManager.loadSession(sessionId);
+    if (!session) {
+      throw new Error(`Session not found: ${sessionId}`);
+    }
+    const workingDir = session.workingDir || ctx.cwd;
+    const manager = new SessionManager(workingDir);
+    const planPath = manager.getSessionPlanPath(sessionId);
+    const plan = await loadPlan(planPath);
+    if (!plan) {
+      return { sessionId, plan: null };
+    }
+    const documentService = new PlanDocumentService(workingDir);
+    const canonicalPath = documentService.getPlanPath(plan);
+    return {
+      sessionId,
+      plan,
+      planPath: await pathExists(canonicalPath) ? canonicalPath : void 0
+    };
+  }
+});
+
+export { get_session_plan_handler_default as default };
+//# sourceMappingURL=get-session-plan-handler.js.map
+//# sourceMappingURL=get-session-plan-handler.js.map

package/dist/rest/handlers/get-session-plan-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/rest/handlers/get-session-plan-handler.ts"],"names":["fs"],"mappings":";;;;;AAcA,eAAe,SAAS,QAAA,EAA4C;AAClE,EAAA,IAAI;AACF,IAAA,MAAM,OAAA,GAAU,MAAMA,QAAA,CAAG,QAAA,CAAS,UAAU,OAAO,CAAA;AACnD,IAAA,OAAO,IAAA,CAAK,MAAM,OAAO,CAAA;AAAA,EAC3B,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,IAAA;AAAA,EACT;AACF;AAEA,eAAe,WAAW,QAAA,EAAoC;AAC5D,EAAA,IAAI;AACF,IAAA,MAAMA,QAAA,CAAG,OAAO,QAAQ,CAAA;AACxB,IAAA,OAAO,IAAA;AAAA,EACT,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,KAAA;AAAA,EACT;AACF;AAEA,IAAO,mCAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,OAAA,CACJ,GAAA,EACA,KAAA,EACiC;AACjC,IAAA,MAAM,SAAS,KAAA,CAAM,MAAA;AACrB,IAAA,MAAM,YAAY,MAAA,EAAQ,SAAA;AAC1B,IAAA,IAAI,CAAC,SAAA,EAAW;AACd,MAAA,MAAM,IAAI,MAAM,wBAAwB,CAAA;AAAA,IAC1C;AAEA,IAAA,MAAM,cAAA,GAAiB,IAAI,cAAA,CAAe,GAAA,CAAI,GAAG,CAAA;AACjD,IAAA,MAAM,OAAA,GAAU,MAAM,cAAA,CAAe,WAAA,CAAY,SAAS,CAAA;AAC1D,IAAA,IAAI,CAAC,OAAA,EAAS;AACZ,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,mBAAA,EAAsB,SAAS,CAAA,CAAE,CAAA;AAAA,IACnD;AAEA,IAAA,MAAM,UAAA,GAAa,OAAA,CAAQ,UAAA,IAAc,GAAA,CAAI,GAAA;AAC7C,IAAA,MAAM,OAAA,GAAU,IAAI,cAAA,CAAe,UAAU,CAAA;AAC7C,IAAA,MAAM,QAAA,GAAW,OAAA,CAAQ,kBAAA,CAAmB,SAAS,CAAA;AACrD,IAAA,MAAM,IAAA,GAAO,MAAM,QAAA,CAAS,QAAQ,CAAA;AAEpC,IAAA,IAAI,CAAC,IAAA,EAAM;AACT,MAAA,OAAO,EAAE,SAAA,EAAW,IAAA,EAAM,IAAA,EAAK;AAAA,IACjC;AAEA,IAAA,MAAM,eAAA,GAAkB,IAAI,mBAAA,CAAoB,UAAU,CAAA;AAC1D,IAAA,MAAM,aAAA,GAAgB,eAAA,CAAgB,WAAA,CAAY,IAAI,CAAA;AAEtD,IAAA,OAAO;AAAA,MACL,SAAA;AAAA,MACA,IAAA;AAAA,MACA,QAAA,EAAU,MAAM,UAAA,CAAW,aAAa,IAAI,aAAA,GAAgB;AAAA,KAC9D;AAAA,EACF;AACF,CAAC","file":"get-session-plan-handler.js","sourcesContent":["/**\n * GET /sessions/:sessionId/plan\n * Get current session plan (JSON + canonical markdown path if present).\n */\n\nimport { defineHandler, type RestInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport { SessionManager, PlanDocumentService } from '@kb-labs/agent-core';\nimport type { GetSessionPlanResponse, TaskPlan } from '@kb-labs/agent-contracts';\nimport { promises as fs } from 'node:fs';\n\ninterface GetSessionPlanRequest {\n  sessionId?: string;\n}\n\nasync function loadPlan(planPath: string): Promise<TaskPlan | null> {\n  try {\n    const content = await fs.readFile(planPath, 'utf-8');\n    return JSON.parse(content) as TaskPlan;\n  } catch {\n    return null;\n  }\n}\n\nasync function pathExists(filePath: string): Promise<boolean> {\n  try {\n    await fs.access(filePath);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nexport default defineHandler({\n  async execute(\n    ctx: PluginContextV3,\n    input: RestInput<GetSessionPlanRequest>\n  ): Promise<GetSessionPlanResponse> {\n    const params = input.params as Record<string, string> | undefined;\n    const sessionId = params?.sessionId;\n    if (!sessionId) {\n      throw new Error('Session ID is required');\n    }\n\n    const sessionManager = new SessionManager(ctx.cwd);\n    const session = await sessionManager.loadSession(sessionId);\n    if (!session) {\n      throw new Error(`Session not found: ${sessionId}`);\n    }\n\n    const workingDir = session.workingDir || ctx.cwd;\n    const manager = new SessionManager(workingDir);\n    const planPath = manager.getSessionPlanPath(sessionId);\n    const plan = await loadPlan(planPath);\n\n    if (!plan) {\n      return { sessionId, plan: null };\n    }\n\n    const documentService = new PlanDocumentService(workingDir);\n    const canonicalPath = documentService.getPlanPath(plan);\n\n    return {\n      sessionId,\n      plan,\n      planPath: await pathExists(canonicalPath) ? canonicalPath : undefined,\n    };\n  },\n});\n"]}

package/dist/rest/handlers/get-session-turns-handler.d.ts

@@ -0,0 +1,16 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { RestInput } from '@kb-labs/sdk';
+import { Turn } from '@kb-labs/agent-contracts';
+
+interface GetSessionTurnsRequest {
+    sessionId?: string;
+    limit?: number;
+    offset?: number;
+}
+interface GetSessionTurnsResponse {
+    turns: Turn[];
+    total: number;
+}
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, RestInput<GetSessionTurnsRequest, unknown, unknown>, GetSessionTurnsResponse>;
+
+export { _default as default };

package/dist/rest/handlers/get-session-turns-handler.js

@@ -0,0 +1,35 @@
+import { defineHandler } from '@kb-labs/sdk';
+import { SessionManager } from '@kb-labs/agent-core';
+
+// src/rest/handlers/get-session-turns-handler.ts
+var get_session_turns_handler_default = defineHandler({
+  async execute(ctx, input) {
+    const params = input.params;
+    const sessionId = params?.sessionId;
+    const query = input.query;
+    if (!sessionId) {
+      throw new Error("Session ID is required");
+    }
+    const sessionManager = new SessionManager(ctx.cwd);
+    ctx.platform.logger.info(`[get-session-turns] cwd: ${ctx.cwd}, sessionId: ${sessionId}`);
+    ctx.platform.logger.info(`[get-session-turns] turnsPath: ${sessionManager.getTurnsPath(sessionId)}`);
+    const session = await sessionManager.loadSession(sessionId);
+    if (!session) {
+      throw new Error(`Session not found: ${sessionId}`);
+    }
+    let turns = await sessionManager.getTurns(sessionId);
+    ctx.platform.logger.info(`[get-session-turns] Found ${turns.length} turns`);
+    const total = turns.length;
+    if (query?.offset) {
+      turns = turns.slice(query.offset);
+    }
+    if (query?.limit) {
+      turns = turns.slice(0, query.limit);
+    }
+    return { turns, total };
+  }
+});
+
+export { get_session_turns_handler_default as default };
+//# sourceMappingURL=get-session-turns-handler.js.map
+//# sourceMappingURL=get-session-turns-handler.js.map

package/dist/rest/handlers/get-session-turns-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/rest/handlers/get-session-turns-handler.ts"],"names":[],"mappings":";;;;AAoBA,IAAO,oCAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,OAAA,CACJ,GAAA,EACA,KAAA,EACkC;AAClC,IAAA,MAAM,SAAS,KAAA,CAAM,MAAA;AACrB,IAAA,MAAM,YAAY,MAAA,EAAQ,SAAA;AAC1B,IAAA,MAAM,QAAQ,KAAA,CAAM,KAAA;AAEpB,IAAA,IAAI,CAAC,SAAA,EAAW;AACd,MAAA,MAAM,IAAI,MAAM,wBAAwB,CAAA;AAAA,IAC1C;AAEA,IAAA,MAAM,cAAA,GAAiB,IAAI,cAAA,CAAe,GAAA,CAAI,GAAG,CAAA;AAEjD,IAAA,GAAA,CAAI,QAAA,CAAS,OAAO,IAAA,CAAK,CAAA,yBAAA,EAA4B,IAAI,GAAG,CAAA,aAAA,EAAgB,SAAS,CAAA,CAAE,CAAA;AACvF,IAAA,GAAA,CAAI,QAAA,CAAS,OAAO,IAAA,CAAK,CAAA,+BAAA,EAAkC,eAAe,YAAA,CAAa,SAAS,CAAC,CAAA,CAAE,CAAA;AAGnG,IAAA,MAAM,OAAA,GAAU,MAAM,cAAA,CAAe,WAAA,CAAY,SAAS,CAAA;AAC1D,IAAA,IAAI,CAAC,OAAA,EAAS;AACZ,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,mBAAA,EAAsB,SAAS,CAAA,CAAE,CAAA;AAAA,IACnD;AAGA,IAAA,IAAI,KAAA,GAAQ,MAAM,cAAA,CAAe,QAAA,CAAS,SAAS,CAAA;AAEnD,IAAA,GAAA,CAAI,SAAS,MAAA,CAAO,IAAA,CAAK,CAAA,0BAAA,EAA6B,KAAA,CAAM,MAAM,CAAA,MAAA,CAAQ,CAAA;AAG1E,IAAA,MAAM,QAAQ,KAAA,CAAM,MAAA;AACpB,IAAA,IAAI,OAAO,MAAA,EAAQ;AACjB,MAAA,KAAA,GAAQ,KAAA,CAAM,KAAA,CAAM,KAAA,CAAM,MAAM,CAAA;AAAA,IAClC;AACA,IAAA,IAAI,OAAO,KAAA,EAAO;AAChB,MAAA,KAAA,GAAQ,KAAA,CAAM,KAAA,CAAM,CAAA,EAAG,KAAA,CAAM,KAAK,CAAA;AAAA,IACpC;AAEA,IAAA,OAAO,EAAE,OAAO,KAAA,EAAM;AAAA,EACxB;AACF,CAAC","file":"get-session-turns-handler.js","sourcesContent":["/**\n * GET /sessions/:sessionId/turns - Get session turns (turn-based UI)\n * NEW (Phase 2): Returns ready-made Turn snapshots instead of raw events\n */\n\nimport { defineHandler, type RestInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport { SessionManager } from '@kb-labs/agent-core';\nimport type { Turn } from '@kb-labs/agent-contracts';\n\ninterface GetSessionTurnsRequest {\n  sessionId?: string;\n  limit?: number;\n  offset?: number;\n}\n\ninterface GetSessionTurnsResponse {\n  turns: Turn[];\n  total: number;\n}\n\nexport default defineHandler({\n  async execute(\n    ctx: PluginContextV3,\n    input: RestInput<GetSessionTurnsRequest>\n  ): Promise<GetSessionTurnsResponse> {\n    const params = input.params as Record<string, string> | undefined;\n    const sessionId = params?.sessionId;\n    const query = input.query as Partial<GetSessionTurnsRequest> | undefined;\n\n    if (!sessionId) {\n      throw new Error('Session ID is required');\n    }\n\n    const sessionManager = new SessionManager(ctx.cwd);\n\n    ctx.platform.logger.info(`[get-session-turns] cwd: ${ctx.cwd}, sessionId: ${sessionId}`);\n    ctx.platform.logger.info(`[get-session-turns] turnsPath: ${sessionManager.getTurnsPath(sessionId)}`);\n\n    // Verify session exists\n    const session = await sessionManager.loadSession(sessionId);\n    if (!session) {\n      throw new Error(`Session not found: ${sessionId}`);\n    }\n\n    // Get turns (with lazy migration from events if needed)\n    let turns = await sessionManager.getTurns(sessionId);\n\n    ctx.platform.logger.info(`[get-session-turns] Found ${turns.length} turns`);\n\n    // Apply pagination\n    const total = turns.length;\n    if (query?.offset) {\n      turns = turns.slice(query.offset);\n    }\n    if (query?.limit) {\n      turns = turns.slice(0, query.limit);\n    }\n\n    return { turns, total };\n  },\n});\n"]}

package/dist/rest/handlers/get-spec-handler.d.ts

@@ -0,0 +1,10 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { RestInput } from '@kb-labs/sdk';
+import { GetSpecResponse } from '@kb-labs/agent-contracts';
+
+interface GetSpecRouteParams {
+    sessionId?: string;
+}
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, RestInput<unknown, unknown, GetSpecRouteParams>, GetSpecResponse>;
+
+export { _default as default };

package/dist/rest/handlers/get-spec-handler.js

@@ -0,0 +1,39 @@
+import { defineHandler } from '@kb-labs/sdk';
+import { SessionManager } from '@kb-labs/agent-core';
+import { promises } from 'fs';
+
+// src/rest/handlers/get-spec-handler.ts
+async function loadSpec(specPath) {
+  try {
+    const content = await promises.readFile(specPath, "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return null;
+  }
+}
+var get_spec_handler_default = defineHandler({
+  async execute(ctx, input) {
+    const params = input.params;
+    const sessionId = params?.sessionId;
+    if (!sessionId) {
+      throw new Error("Session ID is required");
+    }
+    const baseManager = new SessionManager(ctx.cwd);
+    const session = await baseManager.loadSession(sessionId);
+    if (!session) {
+      throw new Error(`Session not found: ${sessionId}`);
+    }
+    const workingDir = session.workingDir || ctx.cwd;
+    const manager = new SessionManager(workingDir);
+    const specPath = manager.getSessionSpecPath(sessionId);
+    const spec = await loadSpec(specPath);
+    return {
+      sessionId,
+      spec
+    };
+  }
+});
+
+export { get_spec_handler_default as default };
+//# sourceMappingURL=get-spec-handler.js.map
+//# sourceMappingURL=get-spec-handler.js.map

package/dist/rest/handlers/get-spec-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/rest/handlers/get-spec-handler.ts"],"names":["fs"],"mappings":";;;;;AAcA,eAAe,SAAS,QAAA,EAA4C;AAClE,EAAA,IAAI;AACF,IAAA,MAAM,OAAA,GAAU,MAAMA,QAAA,CAAG,QAAA,CAAS,UAAU,OAAO,CAAA;AACnD,IAAA,OAAO,IAAA,CAAK,MAAM,OAAO,CAAA;AAAA,EAC3B,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,IAAA;AAAA,EACT;AACF;AAEA,IAAO,2BAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,OAAA,CACJ,GAAA,EACA,KAAA,EAC0B;AAC1B,IAAA,MAAM,SAAS,KAAA,CAAM,MAAA;AACrB,IAAA,MAAM,YAAY,MAAA,EAAQ,SAAA;AAC1B,IAAA,IAAI,CAAC,SAAA,EAAW;AACd,MAAA,MAAM,IAAI,MAAM,wBAAwB,CAAA;AAAA,IAC1C;AAEA,IAAA,MAAM,WAAA,GAAc,IAAI,cAAA,CAAe,GAAA,CAAI,GAAG,CAAA;AAC9C,IAAA,MAAM,OAAA,GAAU,MAAM,WAAA,CAAY,WAAA,CAAY,SAAS,CAAA;AACvD,IAAA,IAAI,CAAC,OAAA,EAAS;AACZ,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,mBAAA,EAAsB,SAAS,CAAA,CAAE,CAAA;AAAA,IACnD;AAEA,IAAA,MAAM,UAAA,GAAa,OAAA,CAAQ,UAAA,IAAc,GAAA,CAAI,GAAA;AAC7C,IAAA,MAAM,OAAA,GAAU,IAAI,cAAA,CAAe,UAAU,CAAA;AAC7C,IAAA,MAAM,QAAA,GAAW,OAAA,CAAQ,kBAAA,CAAmB,SAAS,CAAA;AACrD,IAAA,MAAM,IAAA,GAAO,MAAM,QAAA,CAAS,QAAQ,CAAA;AAEpC,IAAA,OAAO;AAAA,MACL,SAAA;AAAA,MACA;AAAA,KACF;AAAA,EACF;AACF,CAAC","file":"get-spec-handler.js","sourcesContent":["/**\n * GET /sessions/:sessionId/spec\n * Get current session spec (JSON + markdown path if present).\n */\n\nimport { defineHandler, type RestInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport { SessionManager } from '@kb-labs/agent-core';\nimport type { GetSpecResponse, TaskSpec } from '@kb-labs/agent-contracts';\nimport { promises as fs } from 'node:fs';\n\ninterface GetSpecRouteParams {\n  sessionId?: string;\n}\n\nasync function loadSpec(specPath: string): Promise<TaskSpec | null> {\n  try {\n    const content = await fs.readFile(specPath, 'utf-8');\n    return JSON.parse(content) as TaskSpec;\n  } catch {\n    return null;\n  }\n}\n\nexport default defineHandler({\n  async execute(\n    ctx: PluginContextV3,\n    input: RestInput<unknown, unknown, GetSpecRouteParams>\n  ): Promise<GetSpecResponse> {\n    const params = input.params as Record<string, string> | undefined;\n    const sessionId = params?.sessionId;\n    if (!sessionId) {\n      throw new Error('Session ID is required');\n    }\n\n    const baseManager = new SessionManager(ctx.cwd);\n    const session = await baseManager.loadSession(sessionId);\n    if (!session) {\n      throw new Error(`Session not found: ${sessionId}`);\n    }\n\n    const workingDir = session.workingDir || ctx.cwd;\n    const manager = new SessionManager(workingDir);\n    const specPath = manager.getSessionSpecPath(sessionId);\n    const spec = await loadSpec(specPath);\n\n    return {\n      sessionId,\n      spec,\n    };\n  },\n});\n"]}

package/dist/rest/handlers/list-file-changes-handler.d.ts

@@ -0,0 +1,13 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { RestInput } from '@kb-labs/sdk';
+import { FileChangeSummary } from '@kb-labs/agent-history';
+
+interface ListFileChangesResponse {
+    changes: FileChangeSummary[];
+    total: number;
+    sessionId: string;
+    runId?: string;
+}
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, RestInput<unknown, unknown, unknown>, ListFileChangesResponse>;
+
+export { _default as default };

package/dist/rest/handlers/list-file-changes-handler.js

@@ -0,0 +1,34 @@
+import { defineHandler } from '@kb-labs/sdk';
+import { SessionManager } from '@kb-labs/agent-core';
+import { ChangeStore, toSummary } from '@kb-labs/agent-history';
+
+// src/rest/handlers/list-file-changes-handler.ts
+var list_file_changes_handler_default = defineHandler({
+  async execute(ctx, input) {
+    const params = input.params;
+    const sessionId = params?.sessionId;
+    if (!sessionId) {
+      throw new Error("Session ID is required");
+    }
+    const query = input.query;
+    const runId = query?.runId;
+    const sessionManager = new SessionManager(ctx.cwd);
+    const session = await sessionManager.loadSession(sessionId);
+    if (!session) {
+      throw new Error(`Session not found: ${sessionId}`);
+    }
+    const workingDir = session.workingDir || ctx.cwd;
+    const store = new ChangeStore(workingDir);
+    const changes = runId ? await store.listRun(sessionId, runId) : await store.listSession(sessionId);
+    return {
+      changes: changes.map(toSummary),
+      total: changes.length,
+      sessionId,
+      runId
+    };
+  }
+});
+
+export { list_file_changes_handler_default as default };
+//# sourceMappingURL=list-file-changes-handler.js.map
+//# sourceMappingURL=list-file-changes-handler.js.map

package/dist/rest/handlers/list-file-changes-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/rest/handlers/list-file-changes-handler.ts"],"names":[],"mappings":";;;;;AAiBA,IAAO,oCAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,OAAA,CAAQ,GAAA,EAAsB,KAAA,EAAoD;AACtF,IAAA,MAAM,SAAS,KAAA,CAAM,MAAA;AACrB,IAAA,MAAM,YAAY,MAAA,EAAQ,SAAA;AAC1B,IAAA,IAAI,CAAC,SAAA,EAAW;AAAC,MAAA,MAAM,IAAI,MAAM,wBAAwB,CAAA;AAAA,IAAE;AAE3D,IAAA,MAAM,QAAQ,KAAA,CAAM,KAAA;AACpB,IAAA,MAAM,QAAQ,KAAA,EAAO,KAAA;AAErB,IAAA,MAAM,cAAA,GAAiB,IAAI,cAAA,CAAe,GAAA,CAAI,GAAG,CAAA;AACjD,IAAA,MAAM,OAAA,GAAU,MAAM,cAAA,CAAe,WAAA,CAAY,SAAS,CAAA;AAC1D,IAAA,IAAI,CAAC,OAAA,EAAS;AAAC,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,mBAAA,EAAsB,SAAS,CAAA,CAAE,CAAA;AAAA,IAAE;AAElE,IAAA,MAAM,UAAA,GAAa,OAAA,CAAQ,UAAA,IAAc,GAAA,CAAI,GAAA;AAC7C,IAAA,MAAM,KAAA,GAAQ,IAAI,WAAA,CAAY,UAAU,CAAA;AAExC,IAAA,MAAM,OAAA,GAAU,KAAA,GACZ,MAAM,KAAA,CAAM,OAAA,CAAQ,SAAA,EAAW,KAAK,CAAA,GACpC,MAAM,KAAA,CAAM,WAAA,CAAY,SAAS,CAAA;AAErC,IAAA,OAAO;AAAA,MACL,OAAA,EAAS,OAAA,CAAQ,GAAA,CAAI,SAAS,CAAA;AAAA,MAC9B,OAAO,OAAA,CAAQ,MAAA;AAAA,MACf,SAAA;AAAA,MACA;AAAA,KACF;AAAA,EACF;AACF,CAAC","file":"list-file-changes-handler.js","sourcesContent":["/**\n * GET /sessions/:sessionId/changes — List file changes for a session.\n * Optional query: ?runId= to scope to a specific agent run.\n */\n\nimport { defineHandler, type RestInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport { SessionManager } from '@kb-labs/agent-core';\nimport { ChangeStore, toSummary } from '@kb-labs/agent-history';\nimport type { FileChangeSummary } from '@kb-labs/agent-history';\n\ninterface ListFileChangesResponse {\n  changes: FileChangeSummary[];\n  total: number;\n  sessionId: string;\n  runId?: string;\n}\n\nexport default defineHandler({\n  async execute(ctx: PluginContextV3, input: RestInput): Promise<ListFileChangesResponse> {\n    const params = input.params as Record<string, string> | undefined;\n    const sessionId = params?.sessionId;\n    if (!sessionId) {throw new Error('Session ID is required');}\n\n    const query = input.query as Record<string, string> | undefined;\n    const runId = query?.runId;\n\n    const sessionManager = new SessionManager(ctx.cwd);\n    const session = await sessionManager.loadSession(sessionId);\n    if (!session) {throw new Error(`Session not found: ${sessionId}`);}\n\n    const workingDir = session.workingDir || ctx.cwd;\n    const store = new ChangeStore(workingDir);\n\n    const changes = runId\n      ? await store.listRun(sessionId, runId)\n      : await store.listSession(sessionId);\n\n    return {\n      changes: changes.map(toSummary),\n      total: changes.length,\n      sessionId,\n      runId,\n    };\n  },\n});\n"]}

package/dist/rest/handlers/list-sessions-handler.d.ts

@@ -0,0 +1,7 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { RestInput } from '@kb-labs/sdk';
+import { ListSessionsRequest, ListSessionsResponse } from '@kb-labs/agent-contracts';
+
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, RestInput<ListSessionsRequest, unknown, unknown>, ListSessionsResponse>;
+
+export { _default as default };

package/dist/rest/handlers/list-sessions-handler.js

@@ -0,0 +1,23 @@
+import { defineHandler } from '@kb-labs/sdk';
+import { SessionManager } from '@kb-labs/agent-core';
+
+// src/rest/handlers/list-sessions-handler.ts
+var list_sessions_handler_default = defineHandler({
+  async execute(ctx, input) {
+    const query = input.query;
+    const sessionManager = new SessionManager(ctx.cwd);
+    const result = await sessionManager.listSessions({
+      status: query?.status,
+      limit: query?.limit ?? 50,
+      offset: query?.offset ?? 0
+    });
+    return {
+      sessions: result.sessions,
+      total: result.total
+    };
+  }
+});
+
+export { list_sessions_handler_default as default };
+//# sourceMappingURL=list-sessions-handler.js.map
+//# sourceMappingURL=list-sessions-handler.js.map

package/dist/rest/handlers/list-sessions-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/rest/handlers/list-sessions-handler.ts"],"names":[],"mappings":";;;;AAQA,IAAO,gCAAQ,aAAA,CAAc;AAAA,EAC3B,MAAM,OAAA,CACJ,GAAA,EACA,KAAA,EAC+B;AAC/B,IAAA,MAAM,QAAQ,KAAA,CAAM,KAAA;AACpB,IAAA,MAAM,cAAA,GAAiB,IAAI,cAAA,CAAe,GAAA,CAAI,GAAG,CAAA;AAGjD,IAAA,MAAM,MAAA,GAAS,MAAM,cAAA,CAAe,YAAA,CAAa;AAAA,MAC/C,QAAQ,KAAA,EAAO,MAAA;AAAA,MACf,KAAA,EAAO,OAAO,KAAA,IAAS,EAAA;AAAA,MACvB,MAAA,EAAQ,OAAO,MAAA,IAAU;AAAA,KAC1B,CAAA;AAED,IAAA,OAAO;AAAA,MACL,UAAU,MAAA,CAAO,QAAA;AAAA,MACjB,OAAO,MAAA,CAAO;AAAA,KAChB;AAAA,EACF;AACF,CAAC","file":"list-sessions-handler.js","sourcesContent":["/**\n * GET /sessions - List all sessions\n */\n\nimport { defineHandler, type RestInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport { SessionManager } from '@kb-labs/agent-core';\nimport type { ListSessionsRequest, ListSessionsResponse } from '@kb-labs/agent-contracts';\n\nexport default defineHandler({\n  async execute(\n    ctx: PluginContextV3,\n    input: RestInput<ListSessionsRequest>\n  ): Promise<ListSessionsResponse> {\n    const query = input.query as ListSessionsRequest | undefined;\n    const sessionManager = new SessionManager(ctx.cwd);\n\n    // List all sessions (optionally filtered by status)\n    const result = await sessionManager.listSessions({\n      status: query?.status,\n      limit: query?.limit ?? 50,\n      offset: query?.offset ?? 0,\n    });\n\n    return {\n      sessions: result.sessions,\n      total: result.total,\n    };\n  },\n});\n"]}

package/dist/rest/handlers/rollback-handler.d.ts

@@ -0,0 +1,22 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { RestInput } from '@kb-labs/sdk';
+
+interface RollbackRequest {
+    runId?: string;
+    changeIds?: string[];
+    skipConflicts?: boolean;
+}
+interface ConflictEntry {
+    filePath: string;
+    changeId: string;
+    reason: string;
+}
+interface RollbackResponse {
+    rolledBack: number;
+    skipped: number;
+    conflicts: ConflictEntry[];
+    success: boolean;
+}
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, RestInput<RollbackRequest, unknown, unknown>, RollbackResponse>;
+
+export { _default as default };

package/dist/rest/handlers/rollback-handler.js

@@ -0,0 +1,91 @@
+import { defineHandler } from '@kb-labs/sdk';
+import { SessionManager } from '@kb-labs/agent-core';
+import { ChangeStore } from '@kb-labs/agent-history';
+import { promises } from 'fs';
+import path from 'path';
+
+// src/rest/handlers/rollback-handler.ts
+var rollback_handler_default = defineHandler({
+  async execute(ctx, input) {
+    const params = input.params;
+    const sessionId = params?.sessionId;
+    if (!sessionId) {
+      throw new Error("Session ID is required");
+    }
+    const body = input.body ?? {};
+    const sessionManager = new SessionManager(ctx.cwd);
+    const session = await sessionManager.loadSession(sessionId);
+    if (!session) {
+      throw new Error(`Session not found: ${sessionId}`);
+    }
+    const workingDir = session.workingDir || ctx.cwd;
+    const store = new ChangeStore(workingDir);
+    let changes;
+    if (body.runId) {
+      changes = await store.listRun(sessionId, body.runId);
+    } else if (body.changeIds?.length) {
+      const ids = new Set(body.changeIds);
+      const all = await store.listSession(sessionId);
+      changes = all.filter((c) => ids.has(c.id));
+    } else {
+      changes = await store.listSession(sessionId);
+    }
+    if (changes.length === 0) {
+      return { rolledBack: 0, skipped: 0, conflicts: [], success: true };
+    }
+    const sorted = [...changes].sort(
+      (a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime()
+    );
+    const fullHistory = await store.listSession(sessionId);
+    const rollbackIds = new Set(sorted.map((c) => c.id));
+    const conflicts = [];
+    let rolledBack = 0;
+    let skipped = 0;
+    for (const change of sorted) {
+      if (!body.skipConflicts) {
+        const laterChanges = fullHistory.filter(
+          (c) => c.filePath === change.filePath && new Date(c.timestamp).getTime() > new Date(change.timestamp).getTime() && !rollbackIds.has(c.id)
+        );
+        if (laterChanges.length > 0) {
+          const laterAgents = [...new Set(laterChanges.map((c) => c.agentId))].join(", ");
+          conflicts.push({
+            filePath: change.filePath,
+            changeId: change.id,
+            reason: `File was modified after this change by: ${laterAgents}. Use skipConflicts: true to force.`
+          });
+          skipped++;
+          continue;
+        }
+      }
+      const fullPath = path.join(workingDir, change.filePath);
+      try {
+        if (change.before) {
+          await promises.mkdir(path.dirname(fullPath), { recursive: true });
+          await promises.writeFile(fullPath, change.before.content, "utf-8");
+        } else {
+          await promises.unlink(fullPath).catch((e) => {
+            if (e.code !== "ENOENT") {
+              throw e;
+            }
+          });
+        }
+        rolledBack++;
+      } catch (e) {
+        conflicts.push({
+          filePath: change.filePath,
+          changeId: change.id,
+          reason: `Write failed: ${e instanceof Error ? e.message : String(e)}`
+        });
+        skipped++;
+      }
+    }
+    ctx.platform.logger.info(
+      `[rollback-handler] Session ${sessionId}: rolled back ${rolledBack}, skipped ${skipped}`
+    );
+    return { rolledBack, skipped, conflicts, success: skipped === 0 };
+  }
+});
+
+export { rollback_handler_default as default };
+//# sourceMappingURL=rollback-handler.js.map
+//# sourceMappingURL=rollback-handler.js.map

package/dist/rest/handlers/rollback-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/rest/handlers/rollback-handler.ts"],"names":["fsp"],"mappings":"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","file":"rollback-handler.js","sourcesContent":["/**\n * POST /sessions/:sessionId/rollback — Rollback file changes.\n * Body: { runId?: string; changeIds?: string[]; skipConflicts?: boolean }\n */\n\nimport { defineHandler, type RestInput, type PluginContextV3 } from '@kb-labs/sdk';\nimport { SessionManager } from '@kb-labs/agent-core';\nimport { ChangeStore } from '@kb-labs/agent-history';\nimport type { FileChange } from '@kb-labs/agent-history';\nimport { promises as fsp } from 'node:fs';\nimport path from 'node:path';\n\ninterface RollbackRequest {\n  runId?: string;\n  changeIds?: string[];\n  skipConflicts?: boolean;\n}\n\ninterface ConflictEntry {\n  filePath: string;\n  changeId: string;\n  reason: string;\n}\n\ninterface RollbackResponse {\n  rolledBack: number;\n  skipped: number;\n  conflicts: ConflictEntry[];\n  success: boolean;\n}\n\nexport default defineHandler({\n  async execute(ctx: PluginContextV3, input: RestInput<RollbackRequest>): Promise<RollbackResponse> {\n    const params = input.params as Record<string, string> | undefined;\n    const sessionId = params?.sessionId;\n    if (!sessionId) {throw new Error('Session ID is required');}\n\n    const body = (input.body ?? {}) as RollbackRequest;\n\n    const sessionManager = new SessionManager(ctx.cwd);\n    const session = await sessionManager.loadSession(sessionId);\n    if (!session) {throw new Error(`Session not found: ${sessionId}`);}\n\n    const workingDir = session.workingDir || ctx.cwd;\n    const store = new ChangeStore(workingDir);\n\n    let changes: FileChange[];\n    if (body.runId) {\n      changes = await store.listRun(sessionId, body.runId);\n    } else if (body.changeIds?.length) {\n      const ids = new Set(body.changeIds);\n      const all = await store.listSession(sessionId);\n      changes = all.filter((c) => ids.has(c.id));\n    } else {\n      changes = await store.listSession(sessionId);\n    }\n\n    if (changes.length === 0) {\n      return { rolledBack: 0, skipped: 0, conflicts: [], success: true };\n    }\n\n    // Reverse-chronological: undo latest first\n    const sorted = [...changes].sort(\n      (a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime(),\n    );\n\n    // For conflict detection: full session history\n    const fullHistory = await store.listSession(sessionId);\n    const rollbackIds = new Set(sorted.map((c) => c.id));\n\n    const conflicts: ConflictEntry[] = [];\n    let rolledBack = 0;\n    let skipped = 0;\n\n    for (const change of sorted) {\n      // Conflict: newer changes to same file NOT in our rollback set\n      if (!body.skipConflicts) {\n        const laterChanges = fullHistory.filter(\n          (c) =>\n            c.filePath === change.filePath &&\n            new Date(c.timestamp).getTime() > new Date(change.timestamp).getTime() &&\n            !rollbackIds.has(c.id),\n        );\n        if (laterChanges.length > 0) {\n          const laterAgents = [...new Set(laterChanges.map((c) => c.agentId))].join(', ');\n          conflicts.push({\n            filePath: change.filePath,\n            changeId: change.id,\n            reason: `File was modified after this change by: ${laterAgents}. Use skipConflicts: true to force.`,\n          });\n          skipped++;\n          continue;\n        }\n      }\n\n      const fullPath = path.join(workingDir, change.filePath);\n      try {\n        if (change.before) {\n          await fsp.mkdir(path.dirname(fullPath), { recursive: true });\n          await fsp.writeFile(fullPath, change.before.content, 'utf-8');\n        } else {\n          await fsp.unlink(fullPath).catch((e: NodeJS.ErrnoException) => {\n            if (e.code !== 'ENOENT') {throw e;}\n          });\n        }\n        rolledBack++;\n      } catch (e) {\n        conflicts.push({\n          filePath: change.filePath,\n          changeId: change.id,\n          reason: `Write failed: ${e instanceof Error ? e.message : String(e)}`,\n        });\n        skipped++;\n      }\n    }\n\n    ctx.platform.logger.info(\n      `[rollback-handler] Session ${sessionId}: rolled back ${rolledBack}, skipped ${skipped}`,\n    );\n\n    return { rolledBack, skipped, conflicts, success: skipped === 0 };\n  },\n});\n"]}

package/dist/rest/handlers/run-handler.d.ts

@@ -0,0 +1,7 @@
+import * as _kb_labs_shared_command_kit from '@kb-labs/shared-command-kit';
+import { RestInput } from '@kb-labs/sdk';
+import { RunRequest, RunResponse } from '@kb-labs/agent-contracts';
+
+declare const _default: _kb_labs_shared_command_kit.Handler<unknown, RestInput<RunRequest, unknown, unknown>, RunResponse>;
+
+export { _default as default };