axexec 1.0.0

package/dist/agents/copilot/types.d.ts

@@ -0,0 +1,320 @@
+/**
+ * Raw event types from Copilot CLI's JSONL session files.
+ *
+ * These types represent the session events from Copilot CLI,
+ * which are persisted to `~/.copilot/session-state/{sessionId}.jsonl`.
+ *
+ * Copilot CLI writes session events to JSONL files in the session-state
+ * directory. The adapter tails these files and parses each JSONL record.
+ */
+import { z } from "zod";
+/** Session start event - emitted when session begins */
+declare const CopilotSessionStartEvent: z.ZodObject<{
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    parentId: z.ZodNullable<z.ZodString>;
+    ephemeral: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"session.start">;
+    data: z.ZodObject<{
+        sessionId: z.ZodString;
+        version: z.ZodNumber;
+        producer: z.ZodString;
+        copilotVersion: z.ZodString;
+        startTime: z.ZodString;
+        selectedModel: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type CopilotSessionStartEvent = z.infer<typeof CopilotSessionStartEvent>;
+/** Session error event - emitted on session error */
+declare const CopilotSessionErrorEvent: z.ZodObject<{
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    parentId: z.ZodNullable<z.ZodString>;
+    ephemeral: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"session.error">;
+    data: z.ZodObject<{
+        errorType: z.ZodString;
+        message: z.ZodString;
+        stack: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type CopilotSessionErrorEvent = z.infer<typeof CopilotSessionErrorEvent>;
+/** Session model change event - emitted when model is selected/changed */
+declare const CopilotSessionModelChangeEvent: z.ZodObject<{
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    parentId: z.ZodNullable<z.ZodString>;
+    ephemeral: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"session.model_change">;
+    data: z.ZodObject<{
+        previousModel: z.ZodOptional<z.ZodString>;
+        newModel: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type CopilotSessionModelChangeEvent = z.infer<typeof CopilotSessionModelChangeEvent>;
+/** Assistant message event - AI response */
+declare const CopilotAssistantMessageEvent: z.ZodObject<{
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    parentId: z.ZodNullable<z.ZodString>;
+    ephemeral: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"assistant.message">;
+    data: z.ZodObject<{
+        messageId: z.ZodString;
+        content: z.ZodString;
+        chunkContent: z.ZodOptional<z.ZodString>;
+        totalResponseSizeBytes: z.ZodOptional<z.ZodNumber>;
+        toolRequests: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            toolCallId: z.ZodString;
+            name: z.ZodString;
+            arguments: z.ZodOptional<z.ZodUnknown>;
+        }, z.core.$strip>>>;
+        parentToolCallId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type CopilotAssistantMessageEvent = z.infer<typeof CopilotAssistantMessageEvent>;
+/** Assistant turn end event */
+declare const CopilotAssistantTurnEndEvent: z.ZodObject<{
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    parentId: z.ZodNullable<z.ZodString>;
+    ephemeral: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"assistant.turn_end">;
+    data: z.ZodObject<{
+        turnId: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type CopilotAssistantTurnEndEvent = z.infer<typeof CopilotAssistantTurnEndEvent>;
+/** Assistant usage event (ephemeral) - token/cost info */
+declare const CopilotAssistantUsageEvent: z.ZodObject<{
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    parentId: z.ZodNullable<z.ZodString>;
+    type: z.ZodLiteral<"assistant.usage">;
+    ephemeral: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        model: z.ZodOptional<z.ZodString>;
+        inputTokens: z.ZodOptional<z.ZodNumber>;
+        outputTokens: z.ZodOptional<z.ZodNumber>;
+        cacheReadTokens: z.ZodOptional<z.ZodNumber>;
+        cacheWriteTokens: z.ZodOptional<z.ZodNumber>;
+        cost: z.ZodOptional<z.ZodNumber>;
+        duration: z.ZodOptional<z.ZodNumber>;
+        initiator: z.ZodOptional<z.ZodString>;
+        apiCallId: z.ZodOptional<z.ZodString>;
+        providerCallId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type CopilotAssistantUsageEvent = z.infer<typeof CopilotAssistantUsageEvent>;
+/** Tool execution start event */
+declare const CopilotToolExecutionStartEvent: z.ZodObject<{
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    parentId: z.ZodNullable<z.ZodString>;
+    ephemeral: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"tool.execution_start">;
+    data: z.ZodObject<{
+        toolCallId: z.ZodString;
+        toolName: z.ZodString;
+        arguments: z.ZodOptional<z.ZodUnknown>;
+        parentToolCallId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type CopilotToolExecutionStartEvent = z.infer<typeof CopilotToolExecutionStartEvent>;
+/** Tool execution complete event */
+declare const CopilotToolExecutionCompleteEvent: z.ZodObject<{
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    parentId: z.ZodNullable<z.ZodString>;
+    ephemeral: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"tool.execution_complete">;
+    data: z.ZodObject<{
+        toolCallId: z.ZodString;
+        success: z.ZodBoolean;
+        isUserRequested: z.ZodOptional<z.ZodBoolean>;
+        result: z.ZodOptional<z.ZodObject<{
+            content: z.ZodString;
+        }, z.core.$strip>>;
+        error: z.ZodOptional<z.ZodObject<{
+            message: z.ZodString;
+            code: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        parentToolCallId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type CopilotToolExecutionCompleteEvent = z.infer<typeof CopilotToolExecutionCompleteEvent>;
+/** Abort event - session aborted */
+declare const CopilotAbortEvent: z.ZodObject<{
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    parentId: z.ZodNullable<z.ZodString>;
+    ephemeral: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"abort">;
+    data: z.ZodObject<{
+        reason: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+type CopilotAbortEvent = z.infer<typeof CopilotAbortEvent>;
+/** Union of all Copilot CLI event types */
+declare const CopilotEvent: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    parentId: z.ZodNullable<z.ZodString>;
+    ephemeral: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"session.start">;
+    data: z.ZodObject<{
+        sessionId: z.ZodString;
+        version: z.ZodNumber;
+        producer: z.ZodString;
+        copilotVersion: z.ZodString;
+        startTime: z.ZodString;
+        selectedModel: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    parentId: z.ZodNullable<z.ZodString>;
+    ephemeral: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"session.error">;
+    data: z.ZodObject<{
+        errorType: z.ZodString;
+        message: z.ZodString;
+        stack: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    parentId: z.ZodNullable<z.ZodString>;
+    ephemeral: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"session.model_change">;
+    data: z.ZodObject<{
+        previousModel: z.ZodOptional<z.ZodString>;
+        newModel: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    parentId: z.ZodNullable<z.ZodString>;
+    ephemeral: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"user.message">;
+    data: z.ZodObject<{
+        content: z.ZodString;
+        transformedContent: z.ZodOptional<z.ZodString>;
+        attachments: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    parentId: z.ZodNullable<z.ZodString>;
+    ephemeral: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"assistant.message">;
+    data: z.ZodObject<{
+        messageId: z.ZodString;
+        content: z.ZodString;
+        chunkContent: z.ZodOptional<z.ZodString>;
+        totalResponseSizeBytes: z.ZodOptional<z.ZodNumber>;
+        toolRequests: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            toolCallId: z.ZodString;
+            name: z.ZodString;
+            arguments: z.ZodOptional<z.ZodUnknown>;
+        }, z.core.$strip>>>;
+        parentToolCallId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    parentId: z.ZodNullable<z.ZodString>;
+    ephemeral: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"assistant.turn_start">;
+    data: z.ZodObject<{
+        turnId: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    parentId: z.ZodNullable<z.ZodString>;
+    ephemeral: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"assistant.turn_end">;
+    data: z.ZodObject<{
+        turnId: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    parentId: z.ZodNullable<z.ZodString>;
+    type: z.ZodLiteral<"assistant.usage">;
+    ephemeral: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        model: z.ZodOptional<z.ZodString>;
+        inputTokens: z.ZodOptional<z.ZodNumber>;
+        outputTokens: z.ZodOptional<z.ZodNumber>;
+        cacheReadTokens: z.ZodOptional<z.ZodNumber>;
+        cacheWriteTokens: z.ZodOptional<z.ZodNumber>;
+        cost: z.ZodOptional<z.ZodNumber>;
+        duration: z.ZodOptional<z.ZodNumber>;
+        initiator: z.ZodOptional<z.ZodString>;
+        apiCallId: z.ZodOptional<z.ZodString>;
+        providerCallId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    parentId: z.ZodNullable<z.ZodString>;
+    ephemeral: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"tool.execution_start">;
+    data: z.ZodObject<{
+        toolCallId: z.ZodString;
+        toolName: z.ZodString;
+        arguments: z.ZodOptional<z.ZodUnknown>;
+        parentToolCallId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    parentId: z.ZodNullable<z.ZodString>;
+    ephemeral: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"tool.execution_complete">;
+    data: z.ZodObject<{
+        toolCallId: z.ZodString;
+        success: z.ZodBoolean;
+        isUserRequested: z.ZodOptional<z.ZodBoolean>;
+        result: z.ZodOptional<z.ZodObject<{
+            content: z.ZodString;
+        }, z.core.$strip>>;
+        error: z.ZodOptional<z.ZodObject<{
+            message: z.ZodString;
+            code: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        parentToolCallId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodString;
+    timestamp: z.ZodString;
+    parentId: z.ZodNullable<z.ZodString>;
+    ephemeral: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodLiteral<"abort">;
+    data: z.ZodObject<{
+        reason: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>], "type">;
+type CopilotEvent = z.infer<typeof CopilotEvent>;
+/** Type guard for session.start events */
+declare function isSessionStartEvent(event: CopilotEvent): event is CopilotSessionStartEvent;
+/** Type guard for session.error events */
+declare function isSessionErrorEvent(event: CopilotEvent): event is CopilotSessionErrorEvent;
+/** Type guard for session.model_change events */
+declare function isSessionModelChangeEvent(event: CopilotEvent): event is CopilotSessionModelChangeEvent;
+/** Type guard for assistant.turn_end events */
+declare function isAssistantTurnEndEvent(event: CopilotEvent): event is CopilotAssistantTurnEndEvent;
+/** Type guard for assistant.message events */
+declare function isAssistantMessageEvent(event: CopilotEvent): event is CopilotAssistantMessageEvent;
+/** Type guard for assistant.usage events */
+declare function isAssistantUsageEvent(event: CopilotEvent): event is CopilotAssistantUsageEvent;
+/** Type guard for tool.execution_start events */
+declare function isToolExecutionStartEvent(event: CopilotEvent): event is CopilotToolExecutionStartEvent;
+/** Type guard for tool.execution_complete events */
+declare function isToolExecutionCompleteEvent(event: CopilotEvent): event is CopilotToolExecutionCompleteEvent;
+/** Type guard for abort events */
+declare function isAbortEvent(event: CopilotEvent): event is CopilotAbortEvent;
+export { CopilotEvent, isAbortEvent, isAssistantMessageEvent, isAssistantTurnEndEvent, isAssistantUsageEvent, isSessionErrorEvent, isSessionModelChangeEvent, isSessionStartEvent, isToolExecutionCompleteEvent, isToolExecutionStartEvent, };
+export type { CopilotAssistantMessageEvent, CopilotAssistantUsageEvent, CopilotSessionErrorEvent, CopilotSessionStartEvent, CopilotToolExecutionCompleteEvent, CopilotToolExecutionStartEvent, };

package/dist/agents/copilot/types.js

@@ -0,0 +1,220 @@
+/**
+ * Raw event types from Copilot CLI's JSONL session files.
+ *
+ * These types represent the session events from Copilot CLI,
+ * which are persisted to `~/.copilot/session-state/{sessionId}.jsonl`.
+ *
+ * Copilot CLI writes session events to JSONL files in the session-state
+ * directory. The adapter tails these files and parses each JSONL record.
+ */
+import { z } from "zod";
+// =============================================================================
+// Base Event Schema
+// =============================================================================
+/** Base fields present in all Copilot events */
+const CopilotEventBase = z.object({
+    id: z.string(),
+    timestamp: z.string(),
+    parentId: z.string().nullable(),
+    ephemeral: z.boolean().optional(),
+});
+// =============================================================================
+// Session Events
+// =============================================================================
+/** Session start event - emitted when session begins */
+const CopilotSessionStartEvent = CopilotEventBase.extend({
+    type: z.literal("session.start"),
+    data: z.object({
+        sessionId: z.string(),
+        version: z.number(),
+        producer: z.string(),
+        copilotVersion: z.string(),
+        startTime: z.string(),
+        selectedModel: z.string().optional(),
+    }),
+});
+/** Session error event - emitted on session error */
+const CopilotSessionErrorEvent = CopilotEventBase.extend({
+    type: z.literal("session.error"),
+    data: z.object({
+        errorType: z.string(),
+        message: z.string(),
+        stack: z.string().optional(),
+    }),
+});
+/** Session model change event - emitted when model is selected/changed */
+const CopilotSessionModelChangeEvent = CopilotEventBase.extend({
+    type: z.literal("session.model_change"),
+    data: z.object({
+        previousModel: z.string().optional(),
+        newModel: z.string(),
+    }),
+});
+// =============================================================================
+// User Events
+// =============================================================================
+/** User message event - user input */
+const CopilotUserMessageEvent = CopilotEventBase.extend({
+    type: z.literal("user.message"),
+    data: z.object({
+        content: z.string(),
+        transformedContent: z.string().optional(),
+        attachments: z.array(z.unknown()).optional(),
+    }),
+});
+// =============================================================================
+// Assistant Events
+// =============================================================================
+/** Tool request within assistant message */
+const CopilotToolRequest = z.object({
+    toolCallId: z.string(),
+    name: z.string(),
+    arguments: z.unknown().optional(),
+});
+/** Assistant message event - AI response */
+const CopilotAssistantMessageEvent = CopilotEventBase.extend({
+    type: z.literal("assistant.message"),
+    data: z.object({
+        messageId: z.string(),
+        content: z.string(),
+        chunkContent: z.string().optional(),
+        totalResponseSizeBytes: z.number().optional(),
+        toolRequests: z.array(CopilotToolRequest).optional(),
+        parentToolCallId: z.string().optional(),
+    }),
+});
+/** Assistant turn start event */
+const CopilotAssistantTurnStartEvent = CopilotEventBase.extend({
+    type: z.literal("assistant.turn_start"),
+    data: z.object({
+        turnId: z.string(),
+    }),
+});
+/** Assistant turn end event */
+const CopilotAssistantTurnEndEvent = CopilotEventBase.extend({
+    type: z.literal("assistant.turn_end"),
+    data: z.object({
+        turnId: z.string(),
+    }),
+});
+/** Assistant usage event (ephemeral) - token/cost info */
+const CopilotAssistantUsageEvent = CopilotEventBase.extend({
+    type: z.literal("assistant.usage"),
+    ephemeral: z.literal(true),
+    data: z.object({
+        model: z.string().optional(),
+        inputTokens: z.number().optional(),
+        outputTokens: z.number().optional(),
+        cacheReadTokens: z.number().optional(),
+        cacheWriteTokens: z.number().optional(),
+        cost: z.number().optional(),
+        duration: z.number().optional(),
+        initiator: z.string().optional(),
+        apiCallId: z.string().optional(),
+        providerCallId: z.string().optional(),
+    }),
+});
+// =============================================================================
+// Tool Events
+// =============================================================================
+/** Tool execution start event */
+const CopilotToolExecutionStartEvent = CopilotEventBase.extend({
+    type: z.literal("tool.execution_start"),
+    data: z.object({
+        toolCallId: z.string(),
+        toolName: z.string(),
+        arguments: z.unknown().optional(),
+        parentToolCallId: z.string().optional(),
+    }),
+});
+/** Tool execution complete event */
+const CopilotToolExecutionCompleteEvent = CopilotEventBase.extend({
+    type: z.literal("tool.execution_complete"),
+    data: z.object({
+        toolCallId: z.string(),
+        success: z.boolean(),
+        isUserRequested: z.boolean().optional(),
+        result: z
+            .object({
+            content: z.string(),
+        })
+            .optional(),
+        error: z
+            .object({
+            message: z.string(),
+            code: z.string().optional(),
+        })
+            .optional(),
+        parentToolCallId: z.string().optional(),
+    }),
+});
+// =============================================================================
+// Other Events
+// =============================================================================
+/** Abort event - session aborted */
+const CopilotAbortEvent = CopilotEventBase.extend({
+    type: z.literal("abort"),
+    data: z.object({
+        reason: z.string(),
+    }),
+});
+// =============================================================================
+// Union Types
+// =============================================================================
+/** Union of all Copilot CLI event types */
+const CopilotEvent = z.discriminatedUnion("type", [
+    CopilotSessionStartEvent,
+    CopilotSessionErrorEvent,
+    CopilotSessionModelChangeEvent,
+    CopilotUserMessageEvent,
+    CopilotAssistantMessageEvent,
+    CopilotAssistantTurnStartEvent,
+    CopilotAssistantTurnEndEvent,
+    CopilotAssistantUsageEvent,
+    CopilotToolExecutionStartEvent,
+    CopilotToolExecutionCompleteEvent,
+    CopilotAbortEvent,
+]);
+// =============================================================================
+// Type Guards
+// =============================================================================
+/** Type guard for session.start events */
+function isSessionStartEvent(event) {
+    return event.type === "session.start";
+}
+/** Type guard for session.error events */
+function isSessionErrorEvent(event) {
+    return event.type === "session.error";
+}
+/** Type guard for session.model_change events */
+function isSessionModelChangeEvent(event) {
+    return event.type === "session.model_change";
+}
+/** Type guard for assistant.turn_end events */
+function isAssistantTurnEndEvent(event) {
+    return event.type === "assistant.turn_end";
+}
+/** Type guard for assistant.message events */
+function isAssistantMessageEvent(event) {
+    return event.type === "assistant.message";
+}
+/** Type guard for assistant.usage events */
+function isAssistantUsageEvent(event) {
+    return event.type === "assistant.usage";
+}
+/** Type guard for tool.execution_start events */
+function isToolExecutionStartEvent(event) {
+    return event.type === "tool.execution_start";
+}
+/** Type guard for tool.execution_complete events */
+function isToolExecutionCompleteEvent(event) {
+    return event.type === "tool.execution_complete";
+}
+/** Type guard for abort events */
+function isAbortEvent(event) {
+    return event.type === "abort";
+}
+// =============================================================================
+// Exports
+// =============================================================================
+export { CopilotEvent, isAbortEvent, isAssistantMessageEvent, isAssistantTurnEndEvent, isAssistantUsageEvent, isSessionErrorEvent, isSessionModelChangeEvent, isSessionStartEvent, isToolExecutionCompleteEvent, isToolExecutionStartEvent, };

package/dist/agents/copilot/watch-session.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Session file watcher for Copilot CLI.
+ *
+ * Watches ~/.copilot/session-state/ for new session files.
+ *
+ * Copilot CLI has two session file formats:
+ * - Old: ~/.copilot/session-state/<uuid>.jsonl
+ * - New (0.0.380+): ~/.copilot/session-state/<uuid>/events.jsonl
+ *
+ * This module supports both formats for compatibility.
+ */
+/**
+ * Get all existing session entries (both old .jsonl files and new directories).
+ * Returns entry names (not full paths) for comparison.
+ */
+export declare function getExistingSessionFiles(): Set<string>;
+/**
+ * Wait for a new session file to appear.
+ *
+ * Uses both file watching and polling to detect new session files.
+ * Returns a promise that resolves with the new session file path.
+ */
+export declare function waitForSessionFile(existingFiles: Set<string>, timeoutMs?: number): {
+    promise: Promise<string>;
+    cleanup: () => void;
+};