Method createSession

src/kernel/sessioning/session-manager.ts:102–145

* Creates a new session and inserts a row into the database. * @param sessionId - The session identifier. * @param options - Optional agent_type and cwd (default from config). * @returns A Session instance with isNewSession: true. * @throws SessionAlreadyExistsError if the session alread

(
    sessionId = uuid(),
    options?: SessionResolveOptions,
  )

   * @throws SessionAlreadyExistsError if the session already exists.
   */
  async createSession(
    sessionId = uuid(),
    options?: SessionResolveOptions,
  ): Promise<Session> {
    if (this.existsSession(sessionId)) {
      throw new SessionAlreadyExistsError(sessionId);
    }

    const agentType = options?.agentType ?? config.agents.default.type;
    const cwd = options?.cwd ?? config.paths.home;
    const channelId = options?.channelId ?? null;
    const now = Date.now();

    this._db
      .insert(sessions)
      .values({
        id: sessionId,
        agent_type: agentType,
        cwd,
        channel_id: channelId,
        last_message_created_at: null,
        runner_session_id: null,
        created_at: now,
        updated_at: now,
      })
      .run();

    if (options?.firstMessage) {
      this._updateFirstMessage(
        sessionId,
        extractTextContent(options.firstMessage),
      );
    }

    this._logger.info(`Creating session: ${sessionId}`);
    const session = new Session(sessionId, agentType, {
      isNewSession: true,
      cwd,
      runnerSessionId: undefined,
    });
    this._attachWriter(session, sessionId);

    return session;
  }

  /**
   * Creates a session for a handoff from an external Claude Code instance.