import type { SessionStore, SessionWriter } from '../types/session.js';
/**
 * Per-subagent session factory.
 *
 * Director runs produce many parallel transcripts — one per spawned
 * subagent — and we want them all rooted under the same director-run
 * directory so a future `wstack replay <runId>` can rehydrate the whole
 * fleet from a single tree.
 *
 * The factory builds (or accepts) a `SessionStore` whose `dir` points at
 * `<sessionsRoot>/<directorRunId>/`, and returns a small `create()`
 * function that the orchestration layer calls per-spawn. Each call
 * yields a fresh `SessionWriter` whose JSONL file lives in that
 * directory, named by either the caller-supplied `subagentId` (preferred,
 * so the file name is human-readable) or a derived id.
 *
 * **Why a thin factory instead of plumbing options through every spawn
 * site?** Because the director is the only caller that needs this
 * isolation pattern, and shoving `sessionStore` options into
 * `SubagentConfig` would leak storage details into a config shape that
 * agents and the coordinator have no business knowing about.
 */
export interface DirectorSessionFactoryOptions {
    /**
     * Either a parent directory where `<directorRunId>/` will be created,
     * or a pre-built `SessionStore` whose `dir` already points at the
     * director run directory. Tests pass an in-memory store for isolation;
     * production code passes the path under `~/.wrongstack/sessions/`.
     */
    store?: SessionStore | undefined;
    sessionsRoot?: string | undefined;
    /**
     * Director run id — namespaces all subagent JSONLs under one folder.
     * Defaults to a timestamped id; supplied explicitly when resuming a
     * prior fleet manifest.
     */
    directorRunId?: string | undefined;
    /**
     * Session-level trace ID for correlating subagent storage events with
     * the parent session's trace in observability pipelines.
     */
    traceId?: string | undefined;
}
export interface DirectorSessionFactory {
    /** Absolute directory where this director run's transcripts live. */
    readonly dir: string;
    /** The director run id used to namespace the directory. */
    readonly directorRunId: string;
    /**
     * Create a fresh `SessionWriter` for the named subagent. Each
     * subagent gets its own JSONL file. The writer's `id` matches the
     * supplied `subagentId` so disk paths line up with in-memory ids.
     */
    createSubagentSession(args: {
        subagentId: string;
        provider?: string | undefined;
        model?: string | undefined;
        title?: string | undefined;
    }): Promise<SessionWriter>;
}
/**
 * Build a `DirectorSessionFactory`. Pass either a pre-configured
 * `SessionStore` (tests) or a `sessionsRoot` path (production). When
 * neither is supplied the factory throws — there's no sane default for
 * "where do these JSONLs live".
 */
export declare function makeDirectorSessionFactory(opts: DirectorSessionFactoryOptions): DirectorSessionFactory;
//# sourceMappingURL=director-session.d.ts.map