@locusai/sdk 0.16.2 → 0.18.2

package/dist/exec/context-tracker.d.ts

@@ -1,183 +0,0 @@
-/**
- * Artifact types that can be tracked across conversation turns.
- */
-export type ArtifactType = "plan" | "document" | "code" | "task-list" | "diagram" | "config" | "report" | "other";
-/**
- * Represents an artifact created during the session.
- */
-export interface Artifact {
-    /** Unique identifier for the artifact */
-    id: string;
-    /** Human-readable title of the artifact */
-    title: string;
-    /** Type of artifact */
-    type: ArtifactType;
-    /** Content of the artifact (can be markdown, code, etc.) */
-    content: string;
-    /** Timestamp when the artifact was created */
-    createdAt: number;
-    /** Timestamp when the artifact was last updated */
-    updatedAt: number;
-    /** Optional file path if artifact was saved to disk */
-    filePath?: string;
-    /** Optional metadata for additional context */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Task status for tracking progress.
- */
-export type TaskStatus = "pending" | "in_progress" | "completed" | "cancelled";
-/**
- * Represents a task created during the session.
- */
-export interface Task {
-    /** Unique identifier for the task */
-    id: string;
-    /** Human-readable title of the task */
-    title: string;
-    /** Detailed description of the task */
-    description?: string;
-    /** Current status of the task */
-    status: TaskStatus;
-    /** Timestamp when the task was created */
-    createdAt: number;
-    /** Timestamp when the task was last updated */
-    updatedAt: number;
-    /** Optional parent task ID for hierarchical tasks */
-    parentId?: string;
-    /** Optional metadata for additional context */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Serialized state of the ContextTracker for persistence.
- */
-export interface ContextTrackerState {
-    artifacts: Artifact[];
-    tasks: Task[];
-}
-/**
- * Tracks artifacts and tasks created during an AI session to enable
- * context-aware follow-up conversations and reference resolution.
- *
- * The ContextTracker enables multi-turn workflow support by:
- * - Maintaining a registry of artifacts (plans, docs, code) created in the session
- * - Tracking tasks and their status
- * - Resolving natural language references ("the plan", "that doc")
- * - Building context summaries for prompts
- *
- * @example
- * ```typescript
- * const tracker = new ContextTracker();
- *
- * // Track an artifact
- * const artifact = tracker.createArtifact({
- *   title: "Sprint Plan Q1",
- *   type: "plan",
- *   content: "## Week 1\n..."
- * });
- *
- * // Later, resolve a reference
- * const plan = tracker.getReferencedArtifact("the plan");
- *
- * // Build context for next prompt
- * const context = tracker.buildContextSummary();
- * ```
- */
-export declare class ContextTracker {
-    private artifacts;
-    private tasks;
-    /**
-     * Create a new artifact and track it.
-     */
-    createArtifact(params: Omit<Artifact, "id" | "createdAt" | "updatedAt">): Artifact;
-    /**
-     * Track an existing artifact.
-     */
-    trackArtifact(artifact: Artifact): void;
-    /**
-     * Update an existing artifact.
-     */
-    updateArtifact(id: string, updates: Partial<Omit<Artifact, "id" | "createdAt">>): Artifact | null;
-    /**
-     * Get an artifact by ID.
-     */
-    getArtifact(id: string): Artifact | null;
-    /**
-     * Get all tracked artifacts.
-     */
-    getAllArtifacts(): Artifact[];
-    /**
-     * Create a new task and track it.
-     */
-    createTask(params: Omit<Task, "id" | "createdAt" | "updatedAt">): Task;
-    /**
-     * Track an existing task.
-     */
-    trackTask(task: Task): void;
-    /**
-     * Update an existing task.
-     */
-    updateTask(id: string, updates: Partial<Omit<Task, "id" | "createdAt">>): Task | null;
-    /**
-     * Get a task by ID.
-     */
-    getTask(id: string): Task | null;
-    /**
-     * Get all tracked tasks.
-     */
-    getAllTasks(): Task[];
-    /**
-     * Get tasks by status.
-     */
-    getTasksByStatus(status: TaskStatus): Task[];
-    /**
-     * Resolve a natural language reference to an artifact.
-     *
-     * Supports multiple resolution strategies:
-     * 1. Exact ID match
-     * 2. Title contains reference (case-insensitive)
-     * 3. Type-based reference using aliases ("the plan", "that doc")
-     * 4. Keyword matching in title
-     *
-     * @param reference - Natural language reference like "the plan" or "sprint doc"
-     * @returns The matched artifact or null if no match found
-     */
-    getReferencedArtifact(reference: string): Artifact | null;
-    /**
-     * Resolve a natural language reference to a task.
-     *
-     * @param reference - Natural language reference like "the auth task"
-     * @returns The matched task or null if no match found
-     */
-    getReferencedTask(reference: string): Task | null;
-    /**
-     * Build a context summary for inclusion in prompts.
-     * Provides the AI with awareness of artifacts and tasks from the session.
-     */
-    buildContextSummary(): string;
-    /**
-     * Get a status icon for display.
-     */
-    private getStatusIcon;
-    /**
-     * Check if the tracker has any content.
-     */
-    hasContent(): boolean;
-    /**
-     * Clear all tracked artifacts and tasks.
-     */
-    clear(): void;
-    /**
-     * Serialize the tracker state for persistence.
-     */
-    toJSON(): ContextTrackerState;
-    /**
-     * Restore tracker state from serialized data.
-     */
-    static fromJSON(state: ContextTrackerState): ContextTracker;
-    /**
-     * Restore state into this tracker instance.
-     */
-    restore(state: ContextTrackerState): void;
-}
-//# sourceMappingURL=context-tracker.d.ts.map

package/dist/exec/context-tracker.d.ts.map

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

package/dist/exec/event-emitter.d.ts

@@ -1,117 +0,0 @@
-import { type ExecEvent, type ExecEventListener, type ExecEventMap, ExecEventType } from "./events.js";
-/**
- * Type-safe event emitter for execution progress feedback.
- *
- * Provides methods to emit and listen to execution events with full type safety.
- *
- * @example
- * ```typescript
- * const emitter = new ExecEventEmitter();
- *
- * // Listen to events
- * emitter.on(ExecEventType.TOOL_STARTED, (event) => {
- *   console.log(`Tool started: ${event.data.toolName}`);
- * });
- *
- * // Emit events
- * emitter.emitToolStarted('Read');
- * ```
- */
-export declare class ExecEventEmitter {
-    private emitter;
-    private sessionId;
-    private isSessionActive;
-    private eventLog;
-    private debugMode;
-    constructor(options?: {
-        debug?: boolean;
-    });
-    /**
-     * Get the current session ID.
-     */
-    getSessionId(): string;
-    /**
-     * Check if a session is currently active.
-     */
-    isActive(): boolean;
-    /**
-     * Get the event log for debugging purposes.
-     */
-    getEventLog(): ExecEvent[];
-    /**
-     * Clear the event log.
-     */
-    clearEventLog(): void;
-    /**
-     * Subscribe to a specific event type.
-     */
-    on<K extends ExecEventType>(eventType: K, listener: ExecEventListener<ExecEventMap[K]>): this;
-    /**
-     * Subscribe to a specific event type for a single emission.
-     */
-    once<K extends ExecEventType>(eventType: K, listener: ExecEventListener<ExecEventMap[K]>): this;
-    /**
-     * Unsubscribe from a specific event type.
-     */
-    off<K extends ExecEventType>(eventType: K, listener: ExecEventListener<ExecEventMap[K]>): this;
-    /**
-     * Remove all listeners for a specific event type or all events.
-     */
-    removeAllListeners(eventType?: ExecEventType): this;
-    /**
-     * Emit an event with the given payload.
-     */
-    private emit;
-    /**
-     * Create the base event structure with timestamp.
-     */
-    private createEventBase;
-    /**
-     * Emit SESSION_STARTED event.
-     */
-    emitSessionStarted(options?: {
-        model?: string;
-        provider?: string;
-    }): void;
-    /**
-     * Emit PROMPT_SUBMITTED event.
-     */
-    emitPromptSubmitted(prompt: string, truncated?: boolean): void;
-    /**
-     * Emit THINKING_STARTED event.
-     */
-    emitThinkingStarted(content?: string): void;
-    /**
-     * Emit THINKING_STOPPED event.
-     */
-    emitThinkingStoped(): void;
-    /**
-     * Emit TOOL_STARTED event.
-     */
-    emitToolStarted(toolName: string, toolId?: string): void;
-    /**
-     * Emit TOOL_COMPLETED event.
-     */
-    emitToolCompleted(toolName: string, toolId?: string, result?: unknown, duration?: number): void;
-    /**
-     * Emit TOOL_FAILED event.
-     */
-    emitToolFailed(toolName: string, error: string, toolId?: string): void;
-    /**
-     * Emit TEXT_DELTA event.
-     */
-    emitTextDelta(content: string): void;
-    /**
-     * Emit RESPONSE_COMPLETED event.
-     */
-    emitResponseCompleted(content: string): void;
-    /**
-     * Emit ERROR_OCCURRED event.
-     */
-    emitErrorOccurred(error: string, code?: string): void;
-    /**
-     * Emit SESSION_ENDED event.
-     */
-    emitSessionEnded(success: boolean): void;
-}
-//# sourceMappingURL=event-emitter.d.ts.map

package/dist/exec/event-emitter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"event-emitter.d.ts","sourceRoot":"","sources":["../../src/exec/event-emitter.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,aAAa,EACd,MAAM,aAAa,CAAC;AASrB;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,SAAS,CAAS;gBAEd,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;IAMzC;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,WAAW,IAAI,SAAS,EAAE;IAI1B;;OAEG;IACH,aAAa,IAAI,IAAI;IAIrB;;OAEG;IACH,EAAE,CAAC,CAAC,SAAS,aAAa,EACxB,SAAS,EAAE,CAAC,EACZ,QAAQ,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GAC3C,IAAI;IAKP;;OAEG;IACH,IAAI,CAAC,CAAC,SAAS,aAAa,EAC1B,SAAS,EAAE,CAAC,EACZ,QAAQ,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GAC3C,IAAI;IAKP;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,aAAa,EACzB,SAAS,EAAE,CAAC,EACZ,QAAQ,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GAC3C,IAAI;IAKP;;OAEG;IACH,kBAAkB,CAAC,SAAS,CAAC,EAAE,aAAa,GAAG,IAAI;IASnD;;OAEG;IACH,OAAO,CAAC,IAAI;IAOZ;;OAEG;IACH,OAAO,CAAC,eAAe;IAWvB;;OAEG;IACH,kBAAkB,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAYzE;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAG,IAAI;IAU5D;;OAEG;IACH,mBAAmB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAS3C;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAO1B;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAUxD;;OAEG;IACH,iBAAiB,CACf,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,OAAO,EAChB,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI;IAYP;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAWtE;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IASpC;;OAEG;IACH,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAS5C;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAUrD;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;CAUzC"}

package/dist/exec/events.d.ts

@@ -1,171 +0,0 @@
-/**
- * Event types emitted during AI execution for rich progress feedback.
- */
-export declare enum ExecEventType {
-    /** Session has been initialized and is ready to execute */
-    SESSION_STARTED = "session:started",
-    /** A prompt has been submitted to the AI */
-    PROMPT_SUBMITTED = "prompt:submitted",
-    /** AI has started thinking/reasoning */
-    THINKING_STARTED = "thinking:started",
-    /** AI has stopped thinking/reasoning */
-    THINKING_STOPPED = "thinking:stopped",
-    /** A tool has started execution */
-    TOOL_STARTED = "tool:started",
-    /** A tool has completed successfully */
-    TOOL_COMPLETED = "tool:completed",
-    /** A tool has failed */
-    TOOL_FAILED = "tool:failed",
-    /** Incremental text output from the AI */
-    TEXT_DELTA = "text:delta",
-    /** The AI response has completed */
-    RESPONSE_COMPLETED = "response:completed",
-    /** An error occurred during execution */
-    ERROR_OCCURRED = "error:occurred",
-    /** The session has ended */
-    SESSION_ENDED = "session:ended"
-}
-/**
- * Base interface for all execution events.
- */
-export interface ExecEventBase {
-    type: ExecEventType;
-    timestamp: number;
-}
-/**
- * Event payload for SESSION_STARTED
- */
-export interface SessionStartedEvent extends ExecEventBase {
-    type: ExecEventType.SESSION_STARTED;
-    data: {
-        sessionId: string;
-        model?: string;
-        provider?: string;
-    };
-}
-/**
- * Event payload for PROMPT_SUBMITTED
- */
-export interface PromptSubmittedEvent extends ExecEventBase {
-    type: ExecEventType.PROMPT_SUBMITTED;
-    data: {
-        prompt: string;
-        truncated?: boolean;
-    };
-}
-/**
- * Event payload for THINKING_STARTED
- */
-export interface ThinkingStartedEvent extends ExecEventBase {
-    type: ExecEventType.THINKING_STARTED;
-    data: {
-        content?: string;
-    };
-}
-/**
- * Event payload for THINKING_STOPPED
- */
-export interface ThinkingStoppedEvent extends ExecEventBase {
-    type: ExecEventType.THINKING_STOPPED;
-    data: Record<string, never>;
-}
-/**
- * Event payload for TOOL_STARTED
- */
-export interface ToolStartedEvent extends ExecEventBase {
-    type: ExecEventType.TOOL_STARTED;
-    data: {
-        toolName: string;
-        toolId?: string;
-        parameters?: Record<string, unknown>;
-    };
-}
-/**
- * Event payload for TOOL_COMPLETED
- */
-export interface ToolCompletedEvent extends ExecEventBase {
-    type: ExecEventType.TOOL_COMPLETED;
-    data: {
-        toolName: string;
-        toolId?: string;
-        parameters?: Record<string, unknown>;
-        result?: unknown;
-        /** Duration in milliseconds */
-        duration?: number;
-    };
-}
-/**
- * Event payload for TOOL_FAILED
- */
-export interface ToolFailedEvent extends ExecEventBase {
-    type: ExecEventType.TOOL_FAILED;
-    data: {
-        toolName: string;
-        toolId?: string;
-        parameters?: Record<string, unknown>;
-        error: string;
-    };
-}
-/**
- * Event payload for TEXT_DELTA
- */
-export interface TextDeltaEvent extends ExecEventBase {
-    type: ExecEventType.TEXT_DELTA;
-    data: {
-        content: string;
-    };
-}
-/**
- * Event payload for RESPONSE_COMPLETED
- */
-export interface ResponseCompletedEvent extends ExecEventBase {
-    type: ExecEventType.RESPONSE_COMPLETED;
-    data: {
-        content: string;
-    };
-}
-/**
- * Event payload for ERROR_OCCURRED
- */
-export interface ErrorOccurredEvent extends ExecEventBase {
-    type: ExecEventType.ERROR_OCCURRED;
-    data: {
-        error: string;
-        code?: string;
-    };
-}
-/**
- * Event payload for SESSION_ENDED
- */
-export interface SessionEndedEvent extends ExecEventBase {
-    type: ExecEventType.SESSION_ENDED;
-    data: {
-        sessionId: string;
-        success: boolean;
-    };
-}
-/**
- * Union type of all execution events.
- */
-export type ExecEvent = SessionStartedEvent | PromptSubmittedEvent | ThinkingStartedEvent | ThinkingStoppedEvent | ToolStartedEvent | ToolCompletedEvent | ToolFailedEvent | TextDeltaEvent | ResponseCompletedEvent | ErrorOccurredEvent | SessionEndedEvent;
-/**
- * Event listener callback type.
- */
-export type ExecEventListener<T extends ExecEvent = ExecEvent> = (event: T) => void;
-/**
- * Type-safe event map for ExecEventEmitter.
- */
-export interface ExecEventMap {
-    [ExecEventType.SESSION_STARTED]: SessionStartedEvent;
-    [ExecEventType.PROMPT_SUBMITTED]: PromptSubmittedEvent;
-    [ExecEventType.THINKING_STARTED]: ThinkingStartedEvent;
-    [ExecEventType.THINKING_STOPPED]: ThinkingStoppedEvent;
-    [ExecEventType.TOOL_STARTED]: ToolStartedEvent;
-    [ExecEventType.TOOL_COMPLETED]: ToolCompletedEvent;
-    [ExecEventType.TOOL_FAILED]: ToolFailedEvent;
-    [ExecEventType.TEXT_DELTA]: TextDeltaEvent;
-    [ExecEventType.RESPONSE_COMPLETED]: ResponseCompletedEvent;
-    [ExecEventType.ERROR_OCCURRED]: ErrorOccurredEvent;
-    [ExecEventType.SESSION_ENDED]: SessionEndedEvent;
-}
-//# sourceMappingURL=events.d.ts.map

package/dist/exec/events.d.ts.map

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

package/dist/exec/exec-session.d.ts

@@ -1,164 +0,0 @@
-import type { AiRunner } from "../ai/runner.js";
-import { type Artifact, ContextTracker, type Task } from "./context-tracker.js";
-import { ExecEventEmitter } from "./event-emitter.js";
-import { ExecEventType } from "./events.js";
-import { type ConversationMessage, type ConversationSession, HistoryManager } from "./history-manager.js";
-import type { StreamChunk } from "./types.js";
-/**
- * Configuration options for ExecSession.
- */
-export interface ExecSessionConfig {
-    /** The AI runner to use for execution */
-    aiRunner: AiRunner;
-    /** Project path for history storage */
-    projectPath: string;
-    /** Model name for session metadata */
-    model: string;
-    /** Provider name for session metadata */
-    provider: string;
-    /** Optional session ID to resume */
-    sessionId?: string;
-    /** Maximum messages to include in context (default: 10) */
-    maxContextMessages?: number;
-    /** Enable debug mode for event logging */
-    debug?: boolean;
-}
-/**
- * Result returned after execution completes.
- */
-export interface ExecResult {
-    content: string;
-    toolsUsed: string[];
-    duration: number;
-    success: boolean;
-    error?: string;
-}
-/**
- * Manages AI execution with conversation history persistence.
- *
- * ExecSession wraps an AI runner and automatically:
- * - Maintains conversation history across prompts
- * - Persists history to disk between sessions
- * - Includes recent history in prompts for context
- * - Emits events for progress tracking
- * - Prunes old sessions to prevent unbounded growth
- *
- * @example
- * ```typescript
- * const session = new ExecSession({
- *   aiRunner: myRunner,
- *   projectPath: '/path/to/project',
- *   model: 'claude-sonnet-4-5',
- *   provider: 'claude',
- * });
- *
- * await session.initialize();
- *
- * // Stream execution with history
- * for await (const chunk of session.executeStreaming('Write a function')) {
- *   console.log(chunk);
- * }
- *
- * // Save session for later resume
- * session.save();
- * ```
- */
-export declare class ExecSession {
-    private aiRunner;
-    private history;
-    private currentSession;
-    private eventEmitter;
-    private contextTracker;
-    private maxContextMessages;
-    private model;
-    private provider;
-    private sessionId?;
-    /** Track tool start times for duration calculation */
-    private toolStartTimes;
-    constructor(config: ExecSessionConfig);
-    /**
-     * Initialize the session, loading existing session or creating new one.
-     */
-    initialize(): void;
-    /**
-     * Get the current session.
-     */
-    getSession(): ConversationSession | null;
-    /**
-     * Get the session ID.
-     */
-    getSessionId(): string | null;
-    /**
-     * Get the event emitter for subscribing to execution events.
-     */
-    getEventEmitter(): ExecEventEmitter;
-    /**
-     * Get the history manager.
-     */
-    getHistoryManager(): HistoryManager;
-    /**
-     * Get the context tracker for managing artifacts and tasks.
-     */
-    getContextTracker(): ContextTracker;
-    /**
-     * Create and track an artifact in the session.
-     */
-    createArtifact(params: Omit<Artifact, "id" | "createdAt" | "updatedAt">): Artifact;
-    /**
-     * Create and track a task in the session.
-     */
-    createTask(params: Omit<Task, "id" | "createdAt" | "updatedAt">): Task;
-    /**
-     * Resolve a natural language reference to an artifact.
-     */
-    resolveArtifactReference(reference: string): Artifact | null;
-    /**
-     * Resolve a natural language reference to a task.
-     */
-    resolveTaskReference(reference: string): Task | null;
-    /**
-     * Get conversation messages from the current session.
-     */
-    getMessages(): ConversationMessage[];
-    /**
-     * Add a message to the current session.
-     */
-    addMessage(message: Omit<ConversationMessage, "timestamp">): void;
-    /**
-     * Execute a prompt with streaming output and history context.
-     */
-    executeStreaming(userPrompt: string): AsyncGenerator<StreamChunk, void, unknown>;
-    /**
-     * Execute a prompt without streaming (returns complete result).
-     */
-    execute(userPrompt: string): Promise<ExecResult>;
-    /**
-     * Build a prompt that includes conversation history and context for follow-ups.
-     */
-    private buildPromptWithHistory;
-    /**
-     * Save the current session to disk.
-     */
-    save(): void;
-    /**
-     * Reset the session (clear messages but keep the same session ID).
-     */
-    reset(): void;
-    /**
-     * Start a new session (discards current session if not saved).
-     */
-    startNewSession(): void;
-    /**
-     * End the session and emit completion event.
-     */
-    end(success?: boolean): void;
-    /**
-     * Subscribe to execution events.
-     */
-    on<K extends ExecEventType>(eventType: K, listener: Parameters<ExecEventEmitter["on"]>[1]): this;
-    /**
-     * Unsubscribe from execution events.
-     */
-    off<K extends ExecEventType>(eventType: K, listener: Parameters<ExecEventEmitter["off"]>[1]): this;
-}
-//# sourceMappingURL=exec-session.d.ts.map

package/dist/exec/exec-session.d.ts.map

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