@ai-devkit/agent-manager 0.36.0 → 0.38.0

package/dist/harnesses/copilot/CopilotSessionParser.js

@@ -0,0 +1,236 @@
+import * as path from "path";
+import { AgentStatus } from "../../adapters/AgentAdapter.js";
+import { IncrementalJsonlSummary, reduceJsonlContent } from "../../utils/IncrementalJsonlSummary.js";
+import { JsonlTailReader, normalizeTail } from "../../utils/jsonlTail.js";
+import { safeReadFile, safeStat } from "../../utils/session.js";
+import { isIdle, parseTimestamp, SUMMARY_MAX_LENGTH, truncate } from "../shared.js";
+const VERBOSE_SYSTEM_EVENTS = new Set([
+    "system.message",
+    "session.info",
+    "session.warning",
+    "tool.execution_start",
+    "tool.execution_complete",
+    "function",
+    "abort"
+]);
+const WAITING_EVENTS = new Set([
+    "assistant.message",
+    "assistant.turn_end",
+    "session.shutdown",
+    "abort"
+]);
+export class CopilotSessionParser {
+    /** Incremental reader backing `getConversation({ tail })`. */ tailReader = new JsonlTailReader();
+    eventCache;
+    constructor(options = {}){
+        this.eventCache = new IncrementalJsonlSummary(this.eventReducer, {
+            bounds: options.summaryBounds
+        });
+    }
+    /**
+   * Fold one events.jsonl entry into the O(1) event summary. Mirrors the
+   * original whole-file pass: the latest valid timestamp and event type win,
+   * `session.start` overrides id/cwd/start, and user/assistant text is tracked.
+   *
+   * `skip` (bounded cold start) keeps the head's first user message and clears
+   * the latest timestamp, event type and text, so those come from the tail
+   * only. Tail entries never fill the first user message: beyond the head it
+   * stays "" and the summary falls back to the tail's latest text. The
+   * `session.start` fields (id, cwd, start) are kept from the head and, as in
+   * a full scan, a later `session.start` in the tail still overrides them; one
+   * only in the skipped middle is not seen.
+   */ eventReducer = {
+        initial: ()=>({
+                entryCount: 0,
+                firstUserMessage: "",
+                lastText: ""
+            }),
+        reduce: (state, value)=>{
+            if (value === undefined) return state;
+            const next = {
+                ...state,
+                entryCount: state.entryCount + 1
+            };
+            if (!value || typeof value !== "object") return next;
+            const entry = value;
+            const timestampMs = parseTimestamp(entry.timestamp)?.getTime();
+            if (timestampMs !== undefined) {
+                next.lastActiveMs = timestampMs;
+            }
+            if (entry.type) {
+                next.lastEventType = entry.type;
+            }
+            if (entry.type === "session.start") {
+                next.sessionId = entry.data?.sessionId || next.sessionId;
+                next.projectPath = entry.data?.context?.cwd || next.projectPath;
+                next.sessionStartMs = parseTimestamp(entry.data?.startTime)?.getTime() ?? timestampMs ?? next.sessionStartMs;
+                return next;
+            }
+            const text = this.extractEventText(entry, false);
+            if (!text) return next;
+            if (!next.firstUserMessage && !state.pastHead && entry.type === "user.message") {
+                next.firstUserMessage = text;
+            }
+            if (entry.type === "user.message" || entry.type === "assistant.message") {
+                next.lastText = text;
+            }
+            return next;
+        },
+        skip: (state)=>({
+                entryCount: state.entryCount,
+                pastHead: true,
+                sessionId: state.sessionId,
+                projectPath: state.projectPath,
+                sessionStartMs: state.sessionStartMs,
+                firstUserMessage: state.firstUserMessage,
+                lastText: ""
+            })
+    };
+    readSessionDir(sessionDir, fallbackSessionId) {
+        const eventsFilePath = path.join(sessionDir, "events.jsonl");
+        const content = safeReadFile(eventsFilePath);
+        const events = content === undefined ? this.eventReducer.initial() : reduceJsonlContent(this.eventReducer, content);
+        return this.toSession(sessionDir, fallbackSessionId, events);
+    }
+    /**
+   * Same result as `readSessionDir`, but events.jsonl is summarized through a
+   * per-instance incremental cache so repeated refreshes only parse appended
+   * bytes. Call `pruneSessionCache()` once per refresh.
+   *
+   * The first read of a large events.jsonl is a bounded head + tail scan (see
+   * `eventReducer.skip`); fields whose entries lie only in the skipped middle
+   * fall back to their defaults instead of forcing a full parse.
+   */ readSessionDirIncremental(sessionDir, fallbackSessionId) {
+        const result = this.eventCache.read(path.join(sessionDir, "events.jsonl"));
+        return this.toSession(sessionDir, fallbackSessionId, result?.state ?? this.eventReducer.initial());
+    }
+    /** Evict cached event summaries for files not read since the previous prune. */ pruneSessionCache() {
+        this.eventCache.prune();
+    }
+    toSession(sessionDir, fallbackSessionId, events) {
+        const eventsFilePath = path.join(sessionDir, "events.jsonl");
+        const workspace = this.readWorkspaceMetadata(path.join(sessionDir, "workspace.yaml"));
+        if (events.entryCount === 0 && !this.hasWorkspaceMetadata(workspace)) {
+            return null;
+        }
+        const fileStat = safeStat(eventsFilePath);
+        const defaultStart = workspace.createdAt || fileStat?.birthtime || new Date();
+        const sessionStart = events.sessionStartMs !== undefined ? new Date(events.sessionStartMs) : defaultStart;
+        const lastActive = events.lastActiveMs !== undefined ? new Date(events.lastActiveMs) : workspace.updatedAt || fileStat?.mtime || defaultStart;
+        const summary = events.firstUserMessage || events.lastText || workspace.name || "Copilot session active";
+        return {
+            sessionId: events.sessionId || workspace.id || fallbackSessionId,
+            projectPath: events.projectPath || workspace.cwd || "",
+            summary: truncate(summary, SUMMARY_MAX_LENGTH),
+            sessionStart,
+            lastActive,
+            lastEventType: events.lastEventType,
+            firstUserMessage: events.firstUserMessage,
+            eventsFilePath
+        };
+    }
+    getConversation(sessionFilePath, options) {
+        const verbose = options?.verbose ?? false;
+        const tail = normalizeTail(options?.tail);
+        if (tail !== undefined) {
+            return this.tailReader.read(sessionFilePath, tail, {
+                parseLine: (line)=>{
+                    const entry = this.parseEventLine(line);
+                    return entry ? this.eventToMessage(entry, verbose) : null;
+                }
+            }, String(verbose));
+        }
+        const content = safeReadFile(sessionFilePath);
+        if (content === undefined) return [];
+        const messages = [];
+        for (const entry of this.parseEventLines(content)){
+            const message = this.eventToMessage(entry, verbose);
+            if (message) messages.push(message);
+        }
+        return messages;
+    }
+    eventToMessage(entry, verbose) {
+        const role = this.roleForEvent(entry.type, verbose);
+        if (!role) return null;
+        const text = this.extractEventText(entry, verbose);
+        if (!text) return null;
+        return {
+            role,
+            content: text,
+            timestamp: entry.timestamp
+        };
+    }
+    determineStatus(session) {
+        if (isIdle(session.lastActive)) {
+            return AgentStatus.IDLE;
+        }
+        if (session.lastEventType !== undefined && WAITING_EVENTS.has(session.lastEventType)) {
+            return AgentStatus.WAITING;
+        }
+        return AgentStatus.RUNNING;
+    }
+    hasWorkspaceMetadata(workspace) {
+        return Boolean(workspace.id || workspace.cwd || workspace.name || workspace.createdAt || workspace.updatedAt);
+    }
+    readWorkspaceMetadata(filePath) {
+        const content = safeReadFile(filePath);
+        if (content === undefined) return {};
+        const values = new Map();
+        for (const rawLine of content.split("\n")){
+            const line = rawLine.trim();
+            if (!line || line.startsWith("#")) continue;
+            const idx = line.indexOf(":");
+            if (idx === -1) continue;
+            const key = line.slice(0, idx).trim();
+            const value = this.stripYamlScalar(line.slice(idx + 1).trim());
+            values.set(key, value);
+        }
+        return {
+            id: values.get("id"),
+            cwd: values.get("cwd"),
+            name: values.get("name"),
+            createdAt: parseTimestamp(values.get("created_at")) || undefined,
+            updatedAt: parseTimestamp(values.get("updated_at")) || undefined
+        };
+    }
+    stripYamlScalar(value) {
+        if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+            return value.slice(1, -1);
+        }
+        return value;
+    }
+    parseEventLines(content) {
+        const entries = [];
+        for (const line of content.trim().split("\n")){
+            const entry = this.parseEventLine(line);
+            if (entry) entries.push(entry);
+        }
+        return entries;
+    }
+    parseEventLine(line) {
+        const trimmed = line.trim();
+        if (!trimmed) return null;
+        try {
+            return JSON.parse(trimmed);
+        } catch  {
+            return null;
+        }
+    }
+    roleForEvent(type, verbose) {
+        if (type === "user.message") return "user";
+        if (type === "assistant.message") return "assistant";
+        if (verbose && type !== undefined && VERBOSE_SYSTEM_EVENTS.has(type)) {
+            return "system";
+        }
+        return null;
+    }
+    extractEventText(entry, verbose) {
+        const data = entry.data;
+        if (!data) return "";
+        const raw = data.content || data.message || data.text || data.result?.content || data.result?.detailedContent || (verbose ? data.output : "") || "";
+        if (typeof raw !== "string") return "";
+        return raw.trim();
+    }
+}
+
+//# sourceMappingURL=CopilotSessionParser.js.map

package/dist/harnesses/copilot/CopilotSessionParser.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/harnesses/copilot/CopilotSessionParser.ts"],"sourcesContent":["import * as path from \"path\";\nimport type { ConversationMessage, ConversationOptions } from \"../../adapters/AgentAdapter.js\";\nimport { AgentStatus } from \"../../adapters/AgentAdapter.js\";\nimport {\n  IncrementalJsonlSummary,\n  reduceJsonlContent,\n  type JsonlSummaryBounds,\n  type JsonlSummaryReducer,\n} from \"../../utils/IncrementalJsonlSummary.js\";\nimport { JsonlTailReader, normalizeTail } from \"../../utils/jsonlTail.js\";\nimport { safeReadFile, safeStat } from \"../../utils/session.js\";\nimport { isIdle, parseTimestamp, SUMMARY_MAX_LENGTH, truncate } from \"../shared.js\";\n\ninterface CopilotEventEntry {\n  type?: string;\n  data?: {\n    sessionId?: string;\n    startTime?: string;\n    context?: {\n      cwd?: string;\n      gitRoot?: string;\n      branch?: string;\n    };\n    content?: string;\n    transformedContent?: string;\n    message?: string;\n    text?: string;\n    result?: {\n      content?: string;\n      detailedContent?: string;\n    };\n    output?: string;\n  };\n  timestamp?: string;\n}\n\ninterface CopilotWorkspace {\n  id?: string;\n  cwd?: string;\n  name?: string;\n  createdAt?: Date;\n  updatedAt?: Date;\n}\n\nexport interface CopilotSession {\n  sessionId: string;\n  projectPath: string;\n  summary: string;\n  sessionStart: Date;\n  lastActive: Date;\n  lastEventType?: string;\n  firstUserMessage: string;\n  eventsFilePath: string;\n}\n\n/**\n * O(1) running summary of events.jsonl. Timestamps are epoch ms so cached\n * state stays immutable; unset fields fall back to workspace.yaml metadata.\n */\ninterface CopilotEventState {\n  /** Number of lines that parsed as JSON. */\n  entryCount: number;\n  /** A bounded cold start skipped the middle: later lines are not the session's first. */\n  pastHead?: boolean;\n  sessionId?: string;\n  projectPath?: string;\n  sessionStartMs?: number;\n  lastActiveMs?: number;\n  firstUserMessage: string;\n  lastText: string;\n  lastEventType?: string;\n}\n\nconst VERBOSE_SYSTEM_EVENTS = new Set([\n  \"system.message\",\n  \"session.info\",\n  \"session.warning\",\n  \"tool.execution_start\",\n  \"tool.execution_complete\",\n  \"function\",\n  \"abort\",\n]);\nconst WAITING_EVENTS = new Set([\n  \"assistant.message\",\n  \"assistant.turn_end\",\n  \"session.shutdown\",\n  \"abort\",\n]);\n\nexport interface CopilotSessionParserOptions {\n  /** Cold-start scan bounds for `readSessionDirIncremental` (see IncrementalJsonlSummary). */\n  summaryBounds?: JsonlSummaryBounds | false;\n}\n\nexport class CopilotSessionParser {\n  /** Incremental reader backing `getConversation({ tail })`. */\n  private readonly tailReader = new JsonlTailReader();\n\n  private readonly eventCache: IncrementalJsonlSummary<CopilotEventState>;\n\n  constructor(options: CopilotSessionParserOptions = {}) {\n    this.eventCache = new IncrementalJsonlSummary(this.eventReducer, {\n      bounds: options.summaryBounds,\n    });\n  }\n\n  /**\n   * Fold one events.jsonl entry into the O(1) event summary. Mirrors the\n   * original whole-file pass: the latest valid timestamp and event type win,\n   * `session.start` overrides id/cwd/start, and user/assistant text is tracked.\n   *\n   * `skip` (bounded cold start) keeps the head's first user message and clears\n   * the latest timestamp, event type and text, so those come from the tail\n   * only. Tail entries never fill the first user message: beyond the head it\n   * stays \"\" and the summary falls back to the tail's latest text. The\n   * `session.start` fields (id, cwd, start) are kept from the head and, as in\n   * a full scan, a later `session.start` in the tail still overrides them; one\n   * only in the skipped middle is not seen.\n   */\n  private readonly eventReducer: JsonlSummaryReducer<CopilotEventState> = {\n    initial: () => ({ entryCount: 0, firstUserMessage: \"\", lastText: \"\" }),\n    reduce: (state, value) => {\n      if (value === undefined) return state;\n      const next: CopilotEventState = { ...state, entryCount: state.entryCount + 1 };\n      if (!value || typeof value !== \"object\") return next;\n\n      const entry = value as CopilotEventEntry;\n      const timestampMs = parseTimestamp(entry.timestamp)?.getTime();\n      if (timestampMs !== undefined) {\n        next.lastActiveMs = timestampMs;\n      }\n      if (entry.type) {\n        next.lastEventType = entry.type;\n      }\n\n      if (entry.type === \"session.start\") {\n        next.sessionId = entry.data?.sessionId || next.sessionId;\n        next.projectPath = entry.data?.context?.cwd || next.projectPath;\n        next.sessionStartMs =\n          parseTimestamp(entry.data?.startTime)?.getTime() ?? timestampMs ?? next.sessionStartMs;\n        return next;\n      }\n\n      const text = this.extractEventText(entry, false);\n      if (!text) return next;\n\n      if (!next.firstUserMessage && !state.pastHead && entry.type === \"user.message\") {\n        next.firstUserMessage = text;\n      }\n      if (entry.type === \"user.message\" || entry.type === \"assistant.message\") {\n        next.lastText = text;\n      }\n      return next;\n    },\n    skip: (state) => ({\n      entryCount: state.entryCount,\n      pastHead: true,\n      sessionId: state.sessionId,\n      projectPath: state.projectPath,\n      sessionStartMs: state.sessionStartMs,\n      firstUserMessage: state.firstUserMessage,\n      lastText: \"\",\n    }),\n  };\n\n  readSessionDir(sessionDir: string, fallbackSessionId: string): CopilotSession | null {\n    const eventsFilePath = path.join(sessionDir, \"events.jsonl\");\n    const content = safeReadFile(eventsFilePath);\n    const events =\n      content === undefined\n        ? this.eventReducer.initial()\n        : reduceJsonlContent(this.eventReducer, content);\n    return this.toSession(sessionDir, fallbackSessionId, events);\n  }\n\n  /**\n   * Same result as `readSessionDir`, but events.jsonl is summarized through a\n   * per-instance incremental cache so repeated refreshes only parse appended\n   * bytes. Call `pruneSessionCache()` once per refresh.\n   *\n   * The first read of a large events.jsonl is a bounded head + tail scan (see\n   * `eventReducer.skip`); fields whose entries lie only in the skipped middle\n   * fall back to their defaults instead of forcing a full parse.\n   */\n  readSessionDirIncremental(sessionDir: string, fallbackSessionId: string): CopilotSession | null {\n    const result = this.eventCache.read(path.join(sessionDir, \"events.jsonl\"));\n    return this.toSession(\n      sessionDir,\n      fallbackSessionId,\n      result?.state ?? this.eventReducer.initial(),\n    );\n  }\n\n  /** Evict cached event summaries for files not read since the previous prune. */\n  pruneSessionCache(): void {\n    this.eventCache.prune();\n  }\n\n  private toSession(\n    sessionDir: string,\n    fallbackSessionId: string,\n    events: CopilotEventState,\n  ): CopilotSession | null {\n    const eventsFilePath = path.join(sessionDir, \"events.jsonl\");\n    const workspace = this.readWorkspaceMetadata(path.join(sessionDir, \"workspace.yaml\"));\n    if (events.entryCount === 0 && !this.hasWorkspaceMetadata(workspace)) {\n      return null;\n    }\n\n    const fileStat = safeStat(eventsFilePath);\n    const defaultStart = workspace.createdAt || fileStat?.birthtime || new Date();\n    const sessionStart =\n      events.sessionStartMs !== undefined ? new Date(events.sessionStartMs) : defaultStart;\n    const lastActive =\n      events.lastActiveMs !== undefined\n        ? new Date(events.lastActiveMs)\n        : workspace.updatedAt || fileStat?.mtime || defaultStart;\n\n    const summary =\n      events.firstUserMessage || events.lastText || workspace.name || \"Copilot session active\";\n\n    return {\n      sessionId: events.sessionId || workspace.id || fallbackSessionId,\n      projectPath: events.projectPath || workspace.cwd || \"\",\n      summary: truncate(summary, SUMMARY_MAX_LENGTH),\n      sessionStart,\n      lastActive,\n      lastEventType: events.lastEventType,\n      firstUserMessage: events.firstUserMessage,\n      eventsFilePath,\n    };\n  }\n\n  getConversation(sessionFilePath: string, options?: ConversationOptions): ConversationMessage[] {\n    const verbose = options?.verbose ?? false;\n    const tail = normalizeTail(options?.tail);\n    if (tail !== undefined) {\n      return this.tailReader.read(\n        sessionFilePath,\n        tail,\n        {\n          parseLine: (line) => {\n            const entry = this.parseEventLine(line);\n            return entry ? this.eventToMessage(entry, verbose) : null;\n          },\n        },\n        String(verbose),\n      );\n    }\n\n    const content = safeReadFile(sessionFilePath);\n    if (content === undefined) return [];\n\n    const messages: ConversationMessage[] = [];\n\n    for (const entry of this.parseEventLines(content)) {\n      const message = this.eventToMessage(entry, verbose);\n      if (message) messages.push(message);\n    }\n\n    return messages;\n  }\n\n  private eventToMessage(entry: CopilotEventEntry, verbose: boolean): ConversationMessage | null {\n    const role = this.roleForEvent(entry.type, verbose);\n    if (!role) return null;\n\n    const text = this.extractEventText(entry, verbose);\n    if (!text) return null;\n\n    return {\n      role,\n      content: text,\n      timestamp: entry.timestamp,\n    };\n  }\n\n  determineStatus(session: CopilotSession): AgentStatus {\n    if (isIdle(session.lastActive)) {\n      return AgentStatus.IDLE;\n    }\n\n    if (session.lastEventType !== undefined && WAITING_EVENTS.has(session.lastEventType)) {\n      return AgentStatus.WAITING;\n    }\n\n    return AgentStatus.RUNNING;\n  }\n\n  private hasWorkspaceMetadata(workspace: CopilotWorkspace): boolean {\n    return Boolean(\n      workspace.id || workspace.cwd || workspace.name || workspace.createdAt || workspace.updatedAt,\n    );\n  }\n\n  private readWorkspaceMetadata(filePath: string): CopilotWorkspace {\n    const content = safeReadFile(filePath);\n    if (content === undefined) return {};\n\n    const values = new Map<string, string>();\n    for (const rawLine of content.split(\"\\n\")) {\n      const line = rawLine.trim();\n      if (!line || line.startsWith(\"#\")) continue;\n\n      const idx = line.indexOf(\":\");\n      if (idx === -1) continue;\n\n      const key = line.slice(0, idx).trim();\n      const value = this.stripYamlScalar(line.slice(idx + 1).trim());\n      values.set(key, value);\n    }\n\n    return {\n      id: values.get(\"id\"),\n      cwd: values.get(\"cwd\"),\n      name: values.get(\"name\"),\n      createdAt: parseTimestamp(values.get(\"created_at\")) || undefined,\n      updatedAt: parseTimestamp(values.get(\"updated_at\")) || undefined,\n    };\n  }\n\n  private stripYamlScalar(value: string): string {\n    if (\n      (value.startsWith('\"') && value.endsWith('\"')) ||\n      (value.startsWith(\"'\") && value.endsWith(\"'\"))\n    ) {\n      return value.slice(1, -1);\n    }\n    return value;\n  }\n\n  private parseEventLines(content: string): CopilotEventEntry[] {\n    const entries: CopilotEventEntry[] = [];\n    for (const line of content.trim().split(\"\\n\")) {\n      const entry = this.parseEventLine(line);\n      if (entry) entries.push(entry);\n    }\n    return entries;\n  }\n\n  private parseEventLine(line: string): CopilotEventEntry | null {\n    const trimmed = line.trim();\n    if (!trimmed) return null;\n\n    try {\n      return JSON.parse(trimmed) as CopilotEventEntry;\n    } catch {\n      return null;\n    }\n  }\n\n  private roleForEvent(\n    type: string | undefined,\n    verbose: boolean,\n  ): ConversationMessage[\"role\"] | null {\n    if (type === \"user.message\") return \"user\";\n    if (type === \"assistant.message\") return \"assistant\";\n    if (verbose && type !== undefined && VERBOSE_SYSTEM_EVENTS.has(type)) {\n      return \"system\";\n    }\n    return null;\n  }\n\n  private extractEventText(entry: CopilotEventEntry, verbose: boolean): string {\n    const data = entry.data;\n    if (!data) return \"\";\n\n    const raw =\n      data.content ||\n      data.message ||\n      data.text ||\n      data.result?.content ||\n      data.result?.detailedContent ||\n      (verbose ? data.output : \"\") ||\n      \"\";\n\n    if (typeof raw !== \"string\") return \"\";\n    return raw.trim();\n  }\n}\n"],"names":["path","AgentStatus","IncrementalJsonlSummary","reduceJsonlContent","JsonlTailReader","normalizeTail","safeReadFile","safeStat","isIdle","parseTimestamp","SUMMARY_MAX_LENGTH","truncate","VERBOSE_SYSTEM_EVENTS","Set","WAITING_EVENTS","CopilotSessionParser","tailReader","eventCache","options","eventReducer","bounds","summaryBounds","initial","entryCount","firstUserMessage","lastText","reduce","state","value","undefined","next","entry","timestampMs","timestamp","getTime","lastActiveMs","type","lastEventType","sessionId","data","projectPath","context","cwd","sessionStartMs","startTime","text","extractEventText","pastHead","skip","readSessionDir","sessionDir","fallbackSessionId","eventsFilePath","join","content","events","toSession","readSessionDirIncremental","result","read","pruneSessionCache","prune","workspace","readWorkspaceMetadata","hasWorkspaceMetadata","fileStat","defaultStart","createdAt","birthtime","Date","sessionStart","lastActive","updatedAt","mtime","summary","name","id","getConversation","sessionFilePath","verbose","tail","parseLine","line","parseEventLine","eventToMessage","String","messages","parseEventLines","message","push","role","roleForEvent","determineStatus","session","IDLE","has","WAITING","RUNNING","Boolean","filePath","values","Map","rawLine","split","trim","startsWith","idx","indexOf","key","slice","stripYamlScalar","set","get","endsWith","entries","trimmed","JSON","parse","raw","detailedContent","output"],"mappings":"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"}

package/dist/harnesses/copilot/readiness.d.ts

@@ -0,0 +1,3 @@
+import type { HarnessReadinessProfile } from "../readiness/types.js";
+export declare const copilotReadiness: HarnessReadinessProfile;
+//# sourceMappingURL=readiness.d.ts.map

package/dist/harnesses/copilot/readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.d.ts","sourceRoot":"","sources":["../../../src/harnesses/copilot/readiness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,uBAAuB,EAExB,MAAM,uBAAuB,CAAC;AAyB/B,eAAO,MAAM,gBAAgB,EAAE,uBAG9B,CAAC"}

package/dist/harnesses/copilot/readiness.js

@@ -0,0 +1,39 @@
+async function authCheck(runtime) {
+    try {
+        await runtime.runCommand("gh", [
+            "auth",
+            "status",
+            "--hostname",
+            "github.com"
+        ]);
+        return {
+            state: "authenticated",
+            source: "gh auth status --hostname github.com",
+            provider: "github",
+            availableProviders: [
+                "GitHub"
+            ],
+            status: "pass",
+            errors: []
+        };
+    } catch  {
+        return {
+            state: "unknown",
+            source: "gh auth status --hostname github.com",
+            provider: null,
+            availableProviders: [
+                "GitHub"
+            ],
+            status: "warn",
+            errors: [
+                "Copilot authentication could not be verified through GitHub CLI"
+            ]
+        };
+    }
+}
+export const copilotReadiness = {
+    configDir: ".copilot",
+    auth: authCheck
+};
+
+//# sourceMappingURL=readiness.js.map

package/dist/harnesses/copilot/readiness.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/harnesses/copilot/readiness.ts"],"sourcesContent":["import type {\n  AuthReadinessCheck,\n  HarnessReadinessProfile,\n  ReadinessRuntime,\n} from \"../readiness/types.js\";\n\nasync function authCheck(runtime: ReadinessRuntime): Promise<AuthReadinessCheck> {\n  try {\n    await runtime.runCommand(\"gh\", [\"auth\", \"status\", \"--hostname\", \"github.com\"]);\n    return {\n      state: \"authenticated\",\n      source: \"gh auth status --hostname github.com\",\n      provider: \"github\",\n      availableProviders: [\"GitHub\"],\n      status: \"pass\",\n      errors: [],\n    };\n  } catch {\n    return {\n      state: \"unknown\",\n      source: \"gh auth status --hostname github.com\",\n      provider: null,\n      availableProviders: [\"GitHub\"],\n      status: \"warn\",\n      errors: [\"Copilot authentication could not be verified through GitHub CLI\"],\n    };\n  }\n}\n\nexport const copilotReadiness: HarnessReadinessProfile = {\n  configDir: \".copilot\",\n  auth: authCheck,\n};\n"],"names":["authCheck","runtime","runCommand","state","source","provider","availableProviders","status","errors","copilotReadiness","configDir","auth"],"mappings":"AAMA,eAAeA,UAAUC,OAAyB;IAChD,IAAI;QACF,MAAMA,QAAQC,UAAU,CAAC,MAAM;YAAC;YAAQ;YAAU;YAAc;SAAa;QAC7E,OAAO;YACLC,OAAO;YACPC,QAAQ;YACRC,UAAU;YACVC,oBAAoB;gBAAC;aAAS;YAC9BC,QAAQ;YACRC,QAAQ,EAAE;QACZ;IACF,EAAE,OAAM;QACN,OAAO;YACLL,OAAO;YACPC,QAAQ;YACRC,UAAU;YACVC,oBAAoB;gBAAC;aAAS;YAC9BC,QAAQ;YACRC,QAAQ;gBAAC;aAAkE;QAC7E;IACF;AACF;AAEA,OAAO,MAAMC,mBAA4C;IACvDC,WAAW;IACXC,MAAMX;AACR,EAAE"}

package/dist/harnesses/gemini/GeminiAgentMapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeminiAgentMapper.d.ts","sourceRoot":"","sources":["../../../src/harnesses/gemini/GeminiAgentMapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAE7E,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGnF,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,GAAE,mBAA+C;IAEpF,iBAAiB,CAAC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS;IAehG,mBAAmB,CAAC,WAAW,EAAE,WAAW,GAAG,SAAS;CAGzD"}

package/dist/harnesses/gemini/GeminiAgentMapper.js

@@ -0,0 +1,30 @@
+import { generateAgentName } from "../../utils/matching.js";
+import { GeminiSessionParser } from "./GeminiSessionParser.js";
+import { processOnlyAgent } from "../shared.js";
+export class GeminiAgentMapper {
+    parser;
+    constructor(parser = new GeminiSessionParser()){
+        this.parser = parser;
+    }
+    mapSessionToAgent(session, processInfo, filePath) {
+        const projectPath = session.projectPath || processInfo.cwd || "";
+        return {
+            name: generateAgentName(projectPath, processInfo.pid),
+            type: "gemini_cli",
+            status: this.parser.determineStatus(session),
+            summary: session.summary || "Gemini CLI session active",
+            pid: processInfo.pid,
+            projectPath,
+            sessionId: session.sessionId,
+            lastActive: session.lastActive,
+            sessionFilePath: filePath
+        };
+    }
+    mapProcessOnlyAgent(processInfo) {
+        return processOnlyAgent("gemini_cli", processInfo, {
+            summary: "Gemini CLI process running"
+        });
+    }
+}
+
+//# sourceMappingURL=GeminiAgentMapper.js.map

package/dist/harnesses/gemini/GeminiAgentMapper.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/harnesses/gemini/GeminiAgentMapper.ts"],"sourcesContent":["import type { AgentInfo, ProcessInfo } from \"../../adapters/AgentAdapter.js\";\nimport { generateAgentName } from \"../../utils/matching.js\";\nimport { GeminiSessionParser, type GeminiSession } from \"./GeminiSessionParser.js\";\nimport { processOnlyAgent } from \"../shared.js\";\n\nexport class GeminiAgentMapper {\n  constructor(private readonly parser: GeminiSessionParser = new GeminiSessionParser()) {}\n\n  mapSessionToAgent(session: GeminiSession, processInfo: ProcessInfo, filePath: string): AgentInfo {\n    const projectPath = session.projectPath || processInfo.cwd || \"\";\n    return {\n      name: generateAgentName(projectPath, processInfo.pid),\n      type: \"gemini_cli\",\n      status: this.parser.determineStatus(session),\n      summary: session.summary || \"Gemini CLI session active\",\n      pid: processInfo.pid,\n      projectPath,\n      sessionId: session.sessionId,\n      lastActive: session.lastActive,\n      sessionFilePath: filePath,\n    };\n  }\n\n  mapProcessOnlyAgent(processInfo: ProcessInfo): AgentInfo {\n    return processOnlyAgent(\"gemini_cli\", processInfo, { summary: \"Gemini CLI process running\" });\n  }\n}\n"],"names":["generateAgentName","GeminiSessionParser","processOnlyAgent","GeminiAgentMapper","parser","mapSessionToAgent","session","processInfo","filePath","projectPath","cwd","name","pid","type","status","determineStatus","summary","sessionId","lastActive","sessionFilePath","mapProcessOnlyAgent"],"mappings":"AACA,SAASA,iBAAiB,QAAQ,0BAA0B;AAC5D,SAASC,mBAAmB,QAA4B,2BAA2B;AACnF,SAASC,gBAAgB,QAAQ,eAAe;AAEhD,OAAO,MAAMC;;IACX,YAAY,AAAiBC,SAA8B,IAAIH,qBAAqB,CAAE;aAAzDG,SAAAA;IAA0D;IAEvFC,kBAAkBC,OAAsB,EAAEC,WAAwB,EAAEC,QAAgB,EAAa;QAC/F,MAAMC,cAAcH,QAAQG,WAAW,IAAIF,YAAYG,GAAG,IAAI;QAC9D,OAAO;YACLC,MAAMX,kBAAkBS,aAAaF,YAAYK,GAAG;YACpDC,MAAM;YACNC,QAAQ,IAAI,CAACV,MAAM,CAACW,eAAe,CAACT;YACpCU,SAASV,QAAQU,OAAO,IAAI;YAC5BJ,KAAKL,YAAYK,GAAG;YACpBH;YACAQ,WAAWX,QAAQW,SAAS;YAC5BC,YAAYZ,QAAQY,UAAU;YAC9BC,iBAAiBX;QACnB;IACF;IAEAY,oBAAoBb,WAAwB,EAAa;QACvD,OAAOL,iBAAiB,cAAcK,aAAa;YAAES,SAAS;QAA6B;IAC7F;AACF"}

package/dist/harnesses/gemini/GeminiCliAdapter.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Gemini CLI Adapter
+ *
+ * Detects running Gemini CLI agents by:
+ * 1. Filtering Gemini Node processes from a shared asynchronous process snapshot
+ * 2. Using snapshot CWD and start-time enrichment
+ * 3. Discovering session files from ~/.gemini/tmp/<shortId>/chats/session-*.jsonl
+ *    (Gemini CLI 0.46+ append-only logs) or legacy session-*.json documents
+ * 4. Matching sessions to processes via shared matchProcessesToSessions()
+ *    using sha256(cwd) === session.projectHash as the resolvedCwd source
+ * 5. Extracting summary from the most recent user message in the session JSON
+ */
+import type { AgentAdapter, AgentInfo, ProcessInfo, ConversationMessage, ConversationOptions, SessionSummary, ListSessionsOptions, AgentDetectionContext } from "../../adapters/AgentAdapter.js";
+import { AgentRegistry } from "../../utils/AgentRegistry.js";
+export interface GeminiCliAdapterOptions {
+    geminiTmpDir?: string;
+}
+export declare class GeminiCliAdapter implements AgentAdapter {
+    readonly type: "gemini_cli";
+    readonly processNames: readonly ["node"];
+    private readonly registry;
+    private readonly parser;
+    private readonly mapper;
+    private readonly locator;
+    constructor(registry?: AgentRegistry, options?: GeminiCliAdapterOptions);
+    canHandle(processInfo: ProcessInfo): boolean;
+    /**
+     * Detect running Gemini CLI agents.
+     *
+     * Gemini CLI ships as a Node script (`bundle/gemini.js` with shebang
+     * `#!/usr/bin/env node`) — unlike Claude Code (native binary per
+     * platform) or Codex CLI (Node wrapper that execs a native Rust
+     * binary). The primary running process is therefore the Node runtime
+     * itself, and `ps aux` lists it as `node /path/to/gemini ...` with
+     * argv[0] = `node`. We scan the Node process pool via the shared
+     * snapshot and keep only those whose command line references the gemini
+     * executable or script via isGeminiExecutable().
+     */
+    detectAgents(context?: AgentDetectionContext): Promise<AgentInfo[]>;
+    getConversation(sessionFilePath: string, options?: ConversationOptions): ConversationMessage[];
+    listSessions(opts?: ListSessionsOptions): Promise<SessionSummary[]>;
+    findSessionsById(sessionId: string): Promise<SessionSummary[]>;
+    private getGeminiProcesses;
+    private mapSessionDiscovery;
+    private mapProcessOnlyAgents;
+    private applyWrapperRegistryName;
+    private deduplicateSessionAgents;
+    private sessionDeduplicationKey;
+    private tryRegistryCache;
+    private isGeminiExecutable;
+}
+//# sourceMappingURL=GeminiCliAdapter.d.ts.map

package/dist/harnesses/gemini/GeminiCliAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeminiCliAdapter.d.ts","sourceRoot":"","sources":["../../../src/harnesses/gemini/GeminiCliAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,WAAW,EACX,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,gCAAgC,CAAC;AAOxC,OAAO,EAAE,aAAa,EAAsB,MAAM,8BAA8B,CAAC;AAMjF,MAAM,WAAW,uBAAuB;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,gBAAiB,YAAW,YAAY;IACnD,QAAQ,CAAC,IAAI,EAAG,YAAY,CAAU;IACtC,QAAQ,CAAC,YAAY,oBAAqB;IAE1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;gBAG7C,QAAQ,GAAE,aAAuC,EACjD,OAAO,GAAE,uBAA4B;IAQvC,SAAS,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO;IAI5C;;;;;;;;;;;OAWG;IACG,YAAY,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAoBzE,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,mBAAmB,EAAE;IAIxF,YAAY,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAanE,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;YAQtD,kBAAkB;IAIhC,OAAO,CAAC,mBAAmB;IAuC3B,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,wBAAwB;IAahC,OAAO,CAAC,wBAAwB;IA4BhC,OAAO,CAAC,uBAAuB;IAQ/B,OAAO,CAAC,gBAAgB;IAmCxB,OAAO,CAAC,kBAAkB;CAa3B"}

package/dist/harnesses/gemini/GeminiCliAdapter.js

@@ -0,0 +1,196 @@
+/**
+ * Gemini CLI Adapter
+ *
+ * Detects running Gemini CLI agents by:
+ * 1. Filtering Gemini Node processes from a shared asynchronous process snapshot
+ * 2. Using snapshot CWD and start-time enrichment
+ * 3. Discovering session files from ~/.gemini/tmp/<shortId>/chats/session-*.jsonl
+ *    (Gemini CLI 0.46+ append-only logs) or legacy session-*.json documents
+ * 4. Matching sessions to processes via shared matchProcessesToSessions()
+ *    using sha256(cwd) === session.projectHash as the resolvedCwd source
+ * 5. Extracting summary from the most recent user message in the session JSON
+ */ import { executableBasename, findWrapperProcess, findWrapperProcessPids } from "../../utils/process.js";
+import { matchProcessesToSessions } from "../../utils/matching.js";
+import { AgentRegistry } from "../../utils/AgentRegistry.js";
+import { GeminiAgentMapper } from "./GeminiAgentMapper.js";
+import { GeminiSessionLocator } from "./GeminiSessionLocator.js";
+import { GeminiSessionParser } from "./GeminiSessionParser.js";
+import { findHarnessProcesses } from "../shared.js";
+export class GeminiCliAdapter {
+    type = "gemini_cli";
+    processNames = [
+        "node"
+    ];
+    registry;
+    parser;
+    mapper;
+    locator;
+    constructor(registry = AgentRegistry.default(), options = {}){
+        this.registry = registry;
+        this.parser = new GeminiSessionParser();
+        this.mapper = new GeminiAgentMapper(this.parser);
+        this.locator = new GeminiSessionLocator(options);
+    }
+    canHandle(processInfo) {
+        return this.isGeminiExecutable(processInfo.command);
+    }
+    /**
+   * Detect running Gemini CLI agents.
+   *
+   * Gemini CLI ships as a Node script (`bundle/gemini.js` with shebang
+   * `#!/usr/bin/env node`) — unlike Claude Code (native binary per
+   * platform) or Codex CLI (Node wrapper that execs a native Rust
+   * binary). The primary running process is therefore the Node runtime
+   * itself, and `ps aux` lists it as `node /path/to/gemini ...` with
+   * argv[0] = `node`. We scan the Node process pool via the shared
+   * snapshot and keep only those whose command line references the gemini
+   * executable or script via isGeminiExecutable().
+   */ async detectAgents(context) {
+        const processes = await this.getGeminiProcesses(context);
+        if (processes.length === 0) return [];
+        const wrapperPids = findWrapperProcessPids(processes);
+        const { cachedAgents, remaining } = this.tryRegistryCache(processes, wrapperPids);
+        if (remaining.length === 0) return this.deduplicateSessionAgents(cachedAgents);
+        const candidateProcesses = remaining.filter((proc)=>!wrapperPids.has(proc.pid));
+        const registryEntriesByPid = new Map(this.registry.list().map((entry)=>[
+                entry.pid,
+                entry
+            ]));
+        const discovery = this.locator.discoverSessions(candidateProcesses);
+        const agents = discovery.sessions.length === 0 ? this.mapProcessOnlyAgents(candidateProcesses, processes, registryEntriesByPid) : this.mapSessionDiscovery(discovery, candidateProcesses, processes, registryEntriesByPid);
+        return this.deduplicateSessionAgents([
+            ...cachedAgents,
+            ...agents
+        ]);
+    }
+    getConversation(sessionFilePath, options) {
+        return this.parser.getConversation(sessionFilePath, options);
+    }
+    async listSessions(opts) {
+        const summaries = [];
+        for (const filePath of this.locator.discoverHistoricalSessionFiles()){
+            const summary = this.parser.fileToSessionSummary(filePath);
+            if (!summary) continue;
+            if (opts?.cwd !== undefined && summary.cwd !== opts.cwd) continue;
+            summaries.push(summary);
+        }
+        return summaries;
+    }
+    async findSessionsById(sessionId) {
+        for (const filePath of this.locator.discoverHistoricalSessionFiles()){
+            const summary = this.parser.fileToSessionSummary(filePath);
+            if (summary?.sessionId === sessionId) return [
+                summary
+            ];
+        }
+        return [];
+    }
+    async getGeminiProcesses(context) {
+        return (await findHarnessProcesses(this, context)).processes;
+    }
+    mapSessionDiscovery(discovery, candidateProcesses, allProcesses, registryEntriesByPid) {
+        const matches = matchProcessesToSessions(candidateProcesses, discovery.sessions);
+        const matchedPids = new Set(matches.map((m)=>m.process.pid));
+        const matchedProcesses = [];
+        const agents = [];
+        for (const match of matches){
+            const sessionData = this.parser.parseSession(undefined, match.session.filePath);
+            if (!sessionData) {
+                matchedPids.delete(match.process.pid);
+                continue;
+            }
+            const agent = this.mapper.mapSessionToAgent(sessionData, match.process, match.session.filePath);
+            this.applyWrapperRegistryName(agent, match.process, allProcesses, registryEntriesByPid);
+            agents.push(agent);
+            matchedProcesses.push(match.process);
+        }
+        const matchedWrapperPids = findWrapperProcessPids(candidateProcesses, matchedProcesses);
+        const unmatchedProcesses = candidateProcesses.filter((process)=>!matchedPids.has(process.pid) && !matchedWrapperPids.has(process.pid));
+        agents.push(...this.mapProcessOnlyAgents(unmatchedProcesses, allProcesses, registryEntriesByPid));
+        return agents;
+    }
+    mapProcessOnlyAgents(processes, allProcesses, registryEntriesByPid) {
+        return processes.map((processInfo)=>{
+            const agent = this.mapper.mapProcessOnlyAgent(processInfo);
+            this.applyWrapperRegistryName(agent, processInfo, allProcesses, registryEntriesByPid);
+            return agent;
+        });
+    }
+    applyWrapperRegistryName(agent, processInfo, processes, registryEntriesByPid) {
+        const wrapper = findWrapperProcess(processes, processInfo);
+        const wrapperEntry = wrapper ? registryEntriesByPid.get(wrapper.pid) : undefined;
+        if (wrapperEntry?.type === this.type) {
+            agent.name = wrapperEntry.name;
+        }
+    }
+    deduplicateSessionAgents(agents) {
+        const bySession = new Map();
+        const result = [];
+        for (const agent of agents){
+            const sessionKey = this.sessionDeduplicationKey(agent);
+            if (!sessionKey) {
+                result.push(agent);
+                continue;
+            }
+            const existing = bySession.get(sessionKey);
+            if (!existing) {
+                bySession.set(sessionKey, agent);
+                result.push(agent);
+                continue;
+            }
+            if (agent.pid > existing.pid) {
+                bySession.set(sessionKey, agent);
+                const index = result.indexOf(existing);
+                if (index >= 0) result[index] = agent;
+            }
+        }
+        return result;
+    }
+    sessionDeduplicationKey(agent) {
+        if (agent.sessionFilePath) return `file:${agent.sessionFilePath}`;
+        if (agent.sessionId && !agent.sessionId.startsWith("pid-")) {
+            return `session:${agent.sessionId}`;
+        }
+        return null;
+    }
+    tryRegistryCache(processes, wrapperPids) {
+        const cachedAgents = [];
+        const remaining = [];
+        const byPid = new Map(this.registry.list().map((e)=>[
+                e.pid,
+                e
+            ]));
+        for (const proc of processes){
+            const entry = byPid.get(proc.pid);
+            if (wrapperPids.has(proc.pid) || !entry || entry.type !== this.type || !entry.sessionFilePath) {
+                remaining.push(proc);
+                continue;
+            }
+            const sessionData = this.parser.parseSession(undefined, entry.sessionFilePath);
+            if (!sessionData) {
+                remaining.push(proc);
+                continue;
+            }
+            cachedAgents.push(this.mapper.mapSessionToAgent(sessionData, proc, entry.sessionFilePath));
+        }
+        return {
+            cachedAgents,
+            remaining
+        };
+    }
+    isGeminiExecutable(command) {
+        // Accept any token in the command line whose basename matches a
+        // known gemini entrypoint. This is intentionally broader than the
+        // other adapters' argv[0]-only check because the Node-script
+        // distribution puts the real gemini path in argv[1..], not argv[0].
+        for (const token of command.trim().split(/\s+/)){
+            const base = executableBasename(token);
+            if (base === "gemini" || base === "gemini.exe" || base === "gemini.js") {
+                return true;
+            }
+        }
+        return false;
+    }
+}
+
+//# sourceMappingURL=GeminiCliAdapter.js.map