@copilot-swarm/core 0.0.13 → 0.0.16

package/dist/session-store.js

@@ -0,0 +1,158 @@
+/**
+ * Session management for grouping related runs (analyze, plan, run, review)
+ * under a single logical feature/project.
+ *
+ * Structure:
+ *   .swarm/
+ *     sessions/
+ *       <sessionId>/
+ *         session.json          # metadata
+ *         runs/<runId>/         # run directories (same layout as before)
+ *         plans/                # plan outputs
+ *         analysis/             # analysis outputs
+ *         latest                # latest run pointer within session
+ *     active-session            # pointer to the active session ID
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+const SESSIONS_DIR = "sessions";
+const ACTIVE_SESSION_FILE = "active-session";
+function sessionsRoot(config) {
+    return path.join(config.repoRoot, config.swarmDir, SESSIONS_DIR);
+}
+function activeSessionPath(config) {
+    return path.join(config.repoRoot, config.swarmDir, ACTIVE_SESSION_FILE);
+}
+function sessionDir(config, sessionId) {
+    return path.join(sessionsRoot(config), sessionId);
+}
+function sessionJsonPath(config, sessionId) {
+    return path.join(sessionDir(config, sessionId), "session.json");
+}
+/** Create a new session and set it as active. */
+export async function createSession(config, name, description) {
+    const id = generateSessionId();
+    const session = {
+        id,
+        name,
+        created: new Date().toISOString(),
+        description,
+    };
+    const dir = sessionDir(config, id);
+    await fs.mkdir(dir, { recursive: true });
+    await fs.writeFile(sessionJsonPath(config, id), JSON.stringify(session, null, 2));
+    // Set as active
+    await setActiveSession(config, id);
+    return session;
+}
+/** List all sessions, sorted by creation date (newest first). */
+export async function listSessions(config) {
+    const root = sessionsRoot(config);
+    try {
+        const entries = await fs.readdir(root, { withFileTypes: true });
+        const sessions = [];
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const jsonPath = path.join(root, entry.name, "session.json");
+            try {
+                const content = await fs.readFile(jsonPath, "utf-8");
+                sessions.push(JSON.parse(content));
+            }
+            catch {
+                // Skip invalid session directories
+            }
+        }
+        sessions.sort((a, b) => b.created.localeCompare(a.created));
+        return sessions;
+    }
+    catch {
+        return [];
+    }
+}
+/** Get a session by ID. */
+export async function getSession(config, sessionId) {
+    try {
+        const content = await fs.readFile(sessionJsonPath(config, sessionId), "utf-8");
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/** Get the active session ID. */
+export async function getActiveSessionId(config) {
+    try {
+        return (await fs.readFile(activeSessionPath(config), "utf-8")).trim();
+    }
+    catch {
+        return null;
+    }
+}
+/** Set the active session. */
+export async function setActiveSession(config, sessionId) {
+    const root = path.join(config.repoRoot, config.swarmDir);
+    await fs.mkdir(root, { recursive: true });
+    await fs.writeFile(activeSessionPath(config), sessionId);
+}
+/**
+ * Resolve the effective session ID for the current command.
+ * Priority: CLI --session flag > active-session file > auto-create default.
+ */
+export async function resolveSessionId(config) {
+    // 1. Explicit CLI flag
+    if (config.sessionId) {
+        const session = await getSession(config, config.sessionId);
+        if (!session) {
+            throw new Error(`Session not found: ${config.sessionId}`);
+        }
+        return config.sessionId;
+    }
+    // 2. Active session pointer
+    const activeId = await getActiveSessionId(config);
+    if (activeId) {
+        const session = await getSession(config, activeId);
+        if (session)
+            return activeId;
+    }
+    // 3. Auto-create a default session, migrating legacy runs if present
+    return migrateOrCreateDefault(config);
+}
+/**
+ * If legacy .swarm/runs/ exists, migrate into a "default" session.
+ * Otherwise, create a fresh default session.
+ */
+async function migrateOrCreateDefault(config) {
+    const swarmRootPath = path.join(config.repoRoot, config.swarmDir);
+    const legacyRunsDir = path.join(swarmRootPath, "runs");
+    const legacyPlansDir = path.join(swarmRootPath, "plans");
+    const legacyAnalysisDir = path.join(swarmRootPath, "analysis");
+    const legacyLatest = path.join(swarmRootPath, "latest");
+    const session = await createSession(config, "default", "Auto-created default session");
+    // Migrate legacy directories if they exist
+    const sDir = sessionDir(config, session.id);
+    for (const [src, dest] of [
+        [legacyRunsDir, path.join(sDir, "runs")],
+        [legacyPlansDir, path.join(sDir, "plans")],
+        [legacyAnalysisDir, path.join(sDir, "analysis")],
+        [legacyLatest, path.join(sDir, "latest")],
+    ]) {
+        try {
+            await fs.access(src);
+            await fs.rename(src, dest);
+        }
+        catch {
+            // Source doesn't exist — skip
+        }
+    }
+    return session.id;
+}
+function generateSessionId() {
+    // Short readable ID: 8 hex chars
+    const bytes = new Uint8Array(4);
+    crypto.getRandomValues(bytes);
+    return Array.from(bytes)
+        .map((b) => b.toString(16).padStart(2, "0"))
+        .join("");
+}
+//# sourceMappingURL=session-store.js.map

package/dist/session-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.js","sourceRoot":"","sources":["../src/session-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAUlC,MAAM,YAAY,GAAG,UAAU,CAAC;AAChC,MAAM,mBAAmB,GAAG,gBAAgB,CAAC;AAE7C,SAAS,YAAY,CAAC,MAAmB;IACvC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAmB;IAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,mBAAmB,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,UAAU,CAAC,MAAmB,EAAE,SAAiB;IACxD,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,eAAe,CAAC,MAAmB,EAAE,SAAiB;IAC7D,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,cAAc,CAAC,CAAC;AAClE,CAAC;AAED,iDAAiD;AACjD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAmB,EAAE,IAAY,EAAE,WAAoB;IACzF,MAAM,EAAE,GAAG,iBAAiB,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAiB;QAC5B,EAAE;QACF,IAAI;QACJ,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACjC,WAAW;KACZ,CAAC;IAEF,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACnC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,MAAM,EAAE,CAAC,SAAS,CAAC,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAElF,gBAAgB;IAChB,MAAM,gBAAgB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAEnC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAmB;IACpD,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,MAAM,QAAQ,GAAmB,EAAE,CAAC;QACpC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;gBAAE,SAAS;YACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;YAC7D,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACrD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAiB,CAAC,CAAC;YACrD,CAAC;YAAC,MAAM,CAAC;gBACP,mCAAmC;YACrC,CAAC;QACH,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAC5D,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,2BAA2B;AAC3B,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAmB,EAAE,SAAiB;IACrE,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC;QAC/E,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAiB,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,iCAAiC;AACjC,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,MAAmB;IAC1D,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,8BAA8B;AAC9B,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAmB,EAAE,SAAiB;IAC3E,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzD,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,EAAE,CAAC,SAAS,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC;AAC3D,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAmB;IACxD,uBAAuB;IACvB,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAC3D,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,sBAAsB,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,MAAM,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,4BAA4B;IAC5B,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAClD,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACnD,IAAI,OAAO;YAAE,OAAO,QAAQ,CAAC;IAC/B,CAAC;IAED,qEAAqE;IACrE,OAAO,sBAAsB,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,sBAAsB,CAAC,MAAmB;IACvD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClE,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IACvD,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACzD,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IAC/D,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IAExD,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,8BAA8B,CAAC,CAAC;IAEvF,2CAA2C;IAC3C,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5C,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI;QACxB,CAAC,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACxC,CAAC,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC1C,CAAC,iBAAiB,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAChD,CAAC,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;KAC1C,EAAE,CAAC;QACF,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACrB,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,8BAA8B;QAChC,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC,EAAE,CAAC;AACpB,CAAC;AAED,SAAS,iBAAiB;IACxB,iCAAiC;IACjC,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAC9B,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;SACrB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;SAC3C,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC"}

package/dist/session.d.ts

@@ -1,4 +1,5 @@
 import type { CopilotSession } from "@github/copilot-sdk";
+import type { SessionRecord } from "./checkpoint.js";
 import type { SwarmConfig } from "./config.js";
 import type { Logger } from "./logger.js";
 import type { PipelineConfig } from "./pipeline-types.js";
@@ -8,7 +9,12 @@ export declare class SessionManager {
     private readonly logger;
     private readonly client;
     private readonly instructionCache;
+    private readonly _sessionLog;
     constructor(config: SwarmConfig, pipeline: PipelineConfig, logger: Logger);
+    /** All Copilot SDK sessions created during this run, keyed by context. */
+    get sessionLog(): Record<string, SessionRecord>;
+    /** Record a session with a context key (e.g. "spec-0", "implement-3/stream-1"). */
+    recordSession(key: string, session: CopilotSession, agent: string, role: string): void;
     start(): Promise<void>;
     stop(): Promise<void>;
     /**
@@ -18,10 +24,10 @@ export declare class SessionManager {
      * - Undefined → fall back to `<agentsDir>/<agentName>.md`
      */
     loadAgentInstructions(agentName: string): Promise<string>;
-    createAgentSession(agentName: string, model?: string): Promise<CopilotSession>;
+    createAgentSession(agentName: string, model?: string, sessionKey?: string): Promise<CopilotSession>;
     createSessionWithInstructions(instructions: string, model?: string): Promise<CopilotSession>;
     send(session: CopilotSession, prompt: string, spinnerLabel?: string): Promise<string>;
-    callIsolated(agentName: string, prompt: string, model?: string): Promise<string>;
-    callIsolatedWithInstructions(instructions: string, prompt: string, spinnerLabel: string, model?: string): Promise<string>;
+    callIsolated(agentName: string, prompt: string, model?: string, sessionKey?: string): Promise<string>;
+    callIsolatedWithInstructions(instructions: string, prompt: string, spinnerLabel: string, model?: string, sessionKey?: string): Promise<string>;
 }
 //# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAK1D,qBAAa,cAAc;IAKvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IANzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;gBAG3C,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM;IAO3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;;;;OAKG;IACG,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA6CzD,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAK9E,6BAA6B,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAqB5F,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQrF,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAuBhF,4BAA4B,CAChC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC;CAsBnB"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAK1D,qBAAa,cAAc;IAMvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;IAC9D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqC;gBAG9C,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM;IAOjC,0EAA0E;IAC1E,IAAI,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAE9C;IAED,mFAAmF;IACnF,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAIhF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;;;;OAKG;IACG,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA6CzD,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAOnG,6BAA6B,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAqB5F,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQrF,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAwBrG,4BAA4B,CAChC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC;CAuBnB"}

package/dist/session.js

@@ -12,6 +12,7 @@ export class SessionManager {
     logger;
     client;
     instructionCache = new Map();
+    _sessionLog = {};
     constructor(config, pipeline, logger) {
         this.config = config;
         this.pipeline = pipeline;
@@ -20,6 +21,14 @@ export class SessionManager {
             logLevel: config.verbose ? "debug" : "warning",
         });
     }
+    /** All Copilot SDK sessions created during this run, keyed by context. */
+    get sessionLog() {
+        return this._sessionLog;
+    }
+    /** Record a session with a context key (e.g. "spec-0", "implement-3/stream-1"). */
+    recordSession(key, session, agent, role) {
+        this._sessionLog[key] = { sessionId: session.sessionId, agent, role };
+    }
     async start() {
         await this.client.start();
     }
@@ -74,9 +83,12 @@ export class SessionManager {
         }
         throw new Error(`Failed to load agent instructions for "${agentName}": not found in repo (${repoFilePath}) or bundled defaults`);
     }
-    async createAgentSession(agentName, model) {
+    async createAgentSession(agentName, model, sessionKey) {
         const instructions = await this.loadAgentInstructions(agentName);
-        return this.createSessionWithInstructions(instructions, model);
+        const session = await this.createSessionWithInstructions(instructions, model);
+        if (sessionKey)
+            this.recordSession(sessionKey, session, agentName, agentName);
+        return session;
     }
     async createSessionWithInstructions(instructions, model) {
         const session = await this.client.createSession({
@@ -104,10 +116,12 @@ export class SessionManager {
         this.logger.newline();
         return response?.data.content ?? "";
     }
-    async callIsolated(agentName, prompt, model) {
+    async callIsolated(agentName, prompt, model, sessionKey) {
         const maxAttempts = this.config.maxRetries;
         for (let attempt = 1; attempt <= maxAttempts; attempt++) {
             const session = await this.createAgentSession(agentName, model);
+            if (sessionKey)
+                this.recordSession(sessionKey, session, agentName, agentName);
             try {
                 const content = await this.send(session, prompt, `${agentName} is working…`);
                 if (!content && attempt < maxAttempts) {
@@ -128,10 +142,12 @@ export class SessionManager {
         }
         return "";
     }
-    async callIsolatedWithInstructions(instructions, prompt, spinnerLabel, model) {
+    async callIsolatedWithInstructions(instructions, prompt, spinnerLabel, model, sessionKey) {
         const maxAttempts = this.config.maxRetries;
         for (let attempt = 1; attempt <= maxAttempts; attempt++) {
             const session = await this.createSessionWithInstructions(instructions, model);
+            if (sessionKey)
+                this.recordSession(sessionKey, session, "inline-agent", "inline-agent");
             try {
                 const content = await this.send(session, prompt, spinnerLabel);
                 if (!content && attempt < maxAttempts) {

package/dist/session.js.map

@@ -1 +1 @@
-{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"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"}

package/dist/textarea.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"textarea.d.ts","sourceRoot":"","sources":["../src/textarea.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAuNH,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAiKhE;AAID,MAAM,WAAW,kBAAkB;IACjC,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA6RpH"}
+{"version":3,"file":"textarea.d.ts","sourceRoot":"","sources":["../src/textarea.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAkRH,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAkLhE;AAID,MAAM,WAAW,kBAAkB;IACjC,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA8SpH"}

package/dist/textarea.js

@@ -62,22 +62,64 @@ function wrapText(text, width) {
         return [""];
     const result = [];
     for (const rawLine of text.split("\n")) {
-        if (rawLine.length <= width) {
-            result.push(rawLine);
-            continue;
-        }
-        let remaining = rawLine;
-        while (remaining.length > width) {
-            let cut = remaining.lastIndexOf(" ", width);
-            if (cut <= 0)
-                cut = width;
-            result.push(remaining.substring(0, cut));
-            remaining = remaining.substring(cut).trimStart();
-        }
-        result.push(remaining);
+        for (const vr of wrapLine(rawLine, width))
+            result.push(vr);
     }
     return result;
 }
+/** Wrap a single line into visual rows at word boundaries. */
+function wrapLine(line, width) {
+    if (width <= 0)
+        return [line];
+    if (line.length <= width)
+        return [line];
+    const rows = [];
+    let remaining = line;
+    while (remaining.length > width) {
+        let cut = remaining.lastIndexOf(" ", width);
+        if (cut <= 0)
+            cut = width;
+        rows.push(remaining.substring(0, cut));
+        remaining = remaining.substring(cut === width ? cut : cut + 1);
+    }
+    rows.push(remaining);
+    return rows;
+}
+/**
+ * Compute the visual row count for a set of lines at a given width.
+ * Also builds a map from logical line index to starting visual row.
+ */
+function computeVisualLayout(lines, width) {
+    const lineStartRow = [];
+    const wrappedLines = [];
+    let total = 0;
+    for (const line of lines) {
+        lineStartRow.push(total);
+        const wrapped = wrapLine(line, width);
+        wrappedLines.push(wrapped);
+        total += wrapped.length;
+    }
+    return { totalVisualRows: total, lineStartRow, wrappedLines };
+}
+/**
+ * Convert a logical cursor position (row, col) to a visual row offset and
+ * visual column within the wrapped layout.
+ */
+function logicalToVisual(lineStartRow, wrappedLines, logRow, logCol) {
+    const wrapped = wrappedLines[logRow];
+    let remaining = logCol;
+    for (let i = 0; i < wrapped.length; i++) {
+        const rowLen = wrapped[i].length;
+        // Account for removed space at word-wrap boundary
+        const isLastWrapRow = i === wrapped.length - 1;
+        if (remaining <= rowLen || isLastWrapRow) {
+            return { visualRow: lineStartRow[logRow] + i, visualCol: remaining };
+        }
+        // +1 for the space that was consumed as the wrap point
+        remaining -= rowLen + 1;
+    }
+    return { visualRow: lineStartRow[logRow], visualCol: logCol };
+}
 function renderMenuOverlay(items, selectedIdx, rows, cols) {
     process.stdout.write("\x1b[?25l");
     const boxW = 30;
@@ -143,6 +185,15 @@ function handleEditorKey(ch, i, data, state) {
                     state.curCol = r.col;
                 }
             }
+            // Shift+Enter (ESC[1;2B) → insert newline
+            if (mod === 50 && dir === 66) {
+                const after = state.lines[state.curRow].substring(state.curCol);
+                state.lines[state.curRow] = state.lines[state.curRow].substring(0, state.curCol);
+                state.lines.splice(state.curRow + 1, 0, after);
+                state.curRow++;
+                state.curCol = 0;
+                return { handled: true, newI: i + 5, needsFullRender: true, needsCursorUpdate: false };
+            }
             return { handled: true, newI: i + 5, needsFullRender: false, needsCursorUpdate: true };
         }
         if (code === 65)
@@ -210,13 +261,16 @@ export async function openTextarea() {
     const innerWidth = cols - 4;
     const title = " Task Description ";
     const state = { lines: [""], curRow: 0, curCol: 0 };
-    let scroll = 0;
+    let scroll = 0; // scroll in visual rows
     let menuOpen = false;
     let menuIdx = 0;
     const menuItems = [
         { label: "Submit", value: "submit" },
         { label: "Cancel", value: "cancel" },
     ];
+    function getLayout() {
+        return computeVisualLayout(state.lines, innerWidth);
+    }
     function clamp() {
         if (state.curRow < 0)
             state.curRow = 0;
@@ -226,13 +280,25 @@ export async function openTextarea() {
             state.curCol = 0;
         if (state.curCol > state.lines[state.curRow].length)
             state.curCol = state.lines[state.curRow].length;
-        if (state.curRow < scroll)
-            scroll = state.curRow;
-        if (state.curRow >= scroll + editorHeight)
-            scroll = state.curRow - editorHeight + 1;
+        const layout = getLayout();
+        const vis = logicalToVisual(layout.lineStartRow, layout.wrappedLines, state.curRow, state.curCol);
+        if (vis.visualRow < scroll)
+            scroll = vis.visualRow;
+        if (vis.visualRow >= scroll + editorHeight)
+            scroll = vis.visualRow - editorHeight + 1;
     }
-    function renderLine(screenRow, lineIdx) {
-        const text = lineIdx < state.lines.length ? state.lines[lineIdx] : "";
+    function renderVisualRow(screenRow, visualRowIdx) {
+        const layout = getLayout();
+        // Find which logical line + wrap row this visual row belongs to
+        let text = "";
+        for (let li = 0; li < state.lines.length; li++) {
+            const startVR = layout.lineStartRow[li];
+            const wrapped = layout.wrappedLines[li];
+            if (visualRowIdx >= startVR && visualRowIdx < startVR + wrapped.length) {
+                text = wrapped[visualRowIdx - startVR];
+                break;
+            }
+        }
         const display = text.substring(0, innerWidth);
         const pad = Math.max(0, innerWidth - display.length);
         process.stdout.write(`\x1b[${screenRow};1H\x1b[2K\u2502 ${display}${" ".repeat(pad)} \u2502`);
@@ -245,14 +311,16 @@ export async function openTextarea() {
         process.stdout.write("\x1b[?25l");
         process.stdout.write(`\x1b[1;1H\x1b[2K${top}`);
         for (let i = 0; i < editorHeight; i++)
-            renderLine(2 + i, scroll + i);
+            renderVisualRow(2 + i, scroll + i);
         process.stdout.write(`\x1b[${2 + editorHeight};1H\x1b[2K${bottom}`);
         placeCursor();
         process.stdout.write("\x1b[?25h");
     }
     function placeCursor() {
-        const screenRow = 2 + (state.curRow - scroll);
-        const screenCol = 3 + Math.min(state.curCol, innerWidth);
+        const layout = getLayout();
+        const vis = logicalToVisual(layout.lineStartRow, layout.wrappedLines, state.curRow, state.curCol);
+        const screenRow = 2 + (vis.visualRow - scroll);
+        const screenCol = 3 + Math.min(vis.visualCol, innerWidth);
         process.stdout.write(`\x1b[${screenRow};${screenCol}H`);
     }
     return new Promise((resolve) => {
@@ -347,8 +415,7 @@ export async function openTextarea() {
                             state.lines[state.curRow].substring(state.curCol);
                     state.curCol++;
                     clamp();
-                    renderLine(2 + (state.curRow - scroll), state.curRow);
-                    placeCursor();
+                    needsFullRender = true;
                 }
             }
             if (needsFullRender)
@@ -387,7 +454,7 @@ export async function openSplitEditor(contextText, options) {
     const contextTitle = ` ${options?.contextTitle ?? "Agent Questions"} `;
     // Editor state (left panel)
     const state = { lines: [""], curRow: 0, curCol: 0 };
-    let edScroll = 0;
+    let edScroll = 0; // scroll in visual rows
     // Context state (right panel)
     const ctxLines = wrapText(contextText, rightInner);
     let ctxScroll = 0;
@@ -400,6 +467,9 @@ export async function openSplitEditor(contextText, options) {
         { label: "Skip (use AI judgment)", value: "skip" },
         { label: "Cancel", value: "cancel" },
     ];
+    function getEdLayout() {
+        return computeVisualLayout(state.lines, leftInner);
+    }
     function clampEditor() {
         if (state.curRow < 0)
             state.curRow = 0;
@@ -409,10 +479,12 @@ export async function openSplitEditor(contextText, options) {
             state.curCol = 0;
         if (state.curCol > state.lines[state.curRow].length)
             state.curCol = state.lines[state.curRow].length;
-        if (state.curRow < edScroll)
-            edScroll = state.curRow;
-        if (state.curRow >= edScroll + bodyHeight)
-            edScroll = state.curRow - bodyHeight + 1;
+        const layout = getEdLayout();
+        const vis = logicalToVisual(layout.lineStartRow, layout.wrappedLines, state.curRow, state.curCol);
+        if (vis.visualRow < edScroll)
+            edScroll = vis.visualRow;
+        if (vis.visualRow >= edScroll + bodyHeight)
+            edScroll = vis.visualRow - bodyHeight + 1;
     }
     function clampCtx() {
         if (ctxScroll < 0)
@@ -421,8 +493,18 @@ export async function openSplitEditor(contextText, options) {
             ctxScroll = ctxMaxScroll;
     }
     function renderRow(screenRow, bodyIdx) {
-        const edLineIdx = edScroll + bodyIdx;
-        const edText = edLineIdx < state.lines.length ? state.lines[edLineIdx] : "";
+        // Left panel: get visual row from wrapped editor layout
+        const edVisIdx = edScroll + bodyIdx;
+        const layout = getEdLayout();
+        let edText = "";
+        for (let li = 0; li < state.lines.length; li++) {
+            const startVR = layout.lineStartRow[li];
+            const wrapped = layout.wrappedLines[li];
+            if (edVisIdx >= startVR && edVisIdx < startVR + wrapped.length) {
+                edText = wrapped[edVisIdx - startVR];
+                break;
+            }
+        }
         const edDisplay = edText.substring(0, leftInner);
         const edPad = Math.max(0, leftInner - edDisplay.length);
         const leftDim = focus === "right" ? "\x1b[2m" : "";
@@ -462,8 +544,10 @@ export async function openSplitEditor(contextText, options) {
     }
     function placeCursorSplit() {
         if (focus === "left") {
-            const screenRow = 2 + (state.curRow - edScroll);
-            const screenCol = 3 + Math.min(state.curCol, leftInner);
+            const layout = getEdLayout();
+            const vis = logicalToVisual(layout.lineStartRow, layout.wrappedLines, state.curRow, state.curCol);
+            const screenRow = 2 + (vis.visualRow - edScroll);
+            const screenCol = 3 + Math.min(vis.visualCol, leftInner);
             process.stdout.write(`\x1b[?25h\x1b[${screenRow};${screenCol}H`);
         }
         else {
@@ -632,8 +716,7 @@ export async function openSplitEditor(contextText, options) {
                             state.lines[state.curRow].substring(state.curCol);
                     state.curCol++;
                     clampEditor();
-                    renderRow(2 + (state.curRow - edScroll), state.curRow - edScroll);
-                    placeCursorSplit();
+                    needsFullRender = true;
                 }
             }
             if (needsFullRender)