Class CursorSession

cli/src/cursor/session.ts:15–109

type CursorModelApplyHandler = (model: string | null | undefined) => Promise<string | null>;

export class CursorSession extends AgentSessionBase<EnhancedMode> {
    readonly cursorArgs?: string[];
    model?: string;
    readonly startedBy: 'runner' | 'terminal';
    readonly startingMode: 'local' | 'remote';
    localLaunchFailure: LocalLaunchFailure | null = null;
    private modelApplyHandler: CursorModelApplyHandler | null = null;

    constructor(opts: {
        api: ApiClient;
        client: ApiSessionClient;
        path: string;
        logPath: string;
        sessionId: string | null;
        messageQueue: MessageQueue2<EnhancedMode>;
        onModeChange: (mode: 'local' | 'remote') => void;
        mode?: 'local' | 'remote';
        startedBy: 'runner' | 'terminal';
        startingMode: 'local' | 'remote';
        cursorArgs?: string[];
        model?: string;
        permissionMode?: PermissionMode;
    }) {
        super({
            api: opts.api,
            client: opts.client,
            path: opts.path,
            logPath: opts.logPath,
            sessionId: opts.sessionId,
            messageQueue: opts.messageQueue,
            onModeChange: opts.onModeChange,
            mode: opts.mode,
            sessionLabel: 'CursorSession',
            sessionIdLabel: 'Cursor',
            applySessionIdToMetadata: (metadata, sessionId, extras) => ({
                ...metadata,
                cursorSessionId: sessionId,
                ...extras
            }),
            permissionMode: opts.permissionMode
        });

        this.cursorArgs = opts.cursorArgs;
        this.model = opts.model;
        this.startedBy = opts.startedBy;
        this.startingMode = opts.startingMode;
        this.permissionMode = opts.permissionMode;
    }

    setPermissionMode = (mode: PermissionMode): void => {
        this.permissionMode = mode;
    };

    setModel = (model: string | null | undefined): void => {
        this.model = model ?? undefined;
    };

    registerModelApplyHandler = (handler: CursorModelApplyHandler): (() => void) => {