aipanel-cli 0.1.0

package/dist/src/session/SessionManager.d.ts

@@ -0,0 +1,26 @@
+import { Session, SessionTurn, ProviderRef, type Clock, type IdGenerator, type ProviderRefProps, type SessionTurnRole } from "../domain/index.js";
+import { SessionRepository } from "./SessionRepository.js";
+export interface SessionManagerOptions {
+    repository: SessionRepository;
+    clock?: Clock;
+    idGenerator?: IdGenerator;
+}
+export declare class SessionManager {
+    private readonly repository;
+    private readonly clock;
+    private readonly idGenerator;
+    constructor(options: SessionManagerOptions);
+    startOrResume(params?: {
+        sessionId?: string;
+        title?: string;
+    }): Promise<Session>;
+    appendTurn(session: Session, params: {
+        role: SessionTurnRole;
+        content: string;
+        artifactIds?: string[];
+    }): Promise<SessionTurn>;
+    appendUserTurn(session: Session, content: string, artifactIds?: string[]): Promise<SessionTurn>;
+    appendAssistantTurn(session: Session, content: string, artifactIds?: string[]): Promise<SessionTurn>;
+    updateProviderRef(session: Session, providerRef: ProviderRef | ProviderRefProps): Promise<Session>;
+    save(session: Session): Promise<Session>;
+}

package/dist/src/session/SessionManager.js

@@ -0,0 +1,60 @@
+import { Session, SessionTurn, ProviderRef, defaultClock, defaultIdGenerator, } from "../domain/index.js";
+import { SessionRepository } from "./SessionRepository.js";
+export class SessionManager {
+    repository;
+    clock;
+    idGenerator;
+    constructor(options) {
+        this.repository = options.repository;
+        this.clock = options.clock ?? defaultClock;
+        this.idGenerator = options.idGenerator ?? defaultIdGenerator;
+    }
+    async startOrResume(params = {}) {
+        if (params.sessionId) {
+            return this.repository.require(params.sessionId);
+        }
+        const session = Session.create({
+            clock: this.clock,
+            idGenerator: this.idGenerator,
+            ...(params.title ? { title: params.title } : {}),
+        });
+        return this.repository.save(session);
+    }
+    async appendTurn(session, params) {
+        const turn = session.createTurn({
+            role: params.role,
+            content: params.content,
+            clock: this.clock,
+            idGenerator: this.idGenerator,
+            ...(params.artifactIds ? { artifactIds: params.artifactIds } : {}),
+        });
+        await this.repository.save(session);
+        return turn;
+    }
+    async appendUserTurn(session, content, artifactIds = []) {
+        return this.appendTurn(session, {
+            role: 'user',
+            content,
+            artifactIds,
+        });
+    }
+    async appendAssistantTurn(session, content, artifactIds = []) {
+        return this.appendTurn(session, {
+            role: 'assistant',
+            content,
+            artifactIds,
+        });
+    }
+    async updateProviderRef(session, providerRef) {
+        const resolved = ProviderRef.from(providerRef);
+        session.upsertProviderRef(new ProviderRef({
+            ...resolved.toJSON(),
+            lastUsedAt: resolved.lastUsedAt ?? this.clock(),
+        }), this.clock());
+        return this.repository.save(session);
+    }
+    async save(session) {
+        return this.repository.save(session);
+    }
+}
+//# sourceMappingURL=SessionManager.js.map

package/dist/src/session/SessionManager.js.map

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

package/dist/src/session/SessionRepository.d.ts

@@ -0,0 +1,14 @@
+import { Session } from "../domain/index.js";
+export interface SessionRepositoryOptions {
+    storageRoot?: string;
+}
+export declare class SessionRepository {
+    private readonly storageRoot;
+    constructor(options?: SessionRepositoryOptions);
+    get sessionsDirectory(): string;
+    filePathFor(sessionId: string): string;
+    save(session: Session): Promise<Session>;
+    get(sessionId: string): Promise<Session | null>;
+    require(sessionId: string): Promise<Session>;
+    list(): Promise<Session[]>;
+}

package/dist/src/session/SessionRepository.js

@@ -0,0 +1,55 @@
+import { mkdir, readdir, readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { Session } from "../domain/index.js";
+export class SessionRepository {
+    storageRoot;
+    constructor(options = {}) {
+        this.storageRoot = options.storageRoot ?? path.join(process.cwd(), '.aipanel');
+    }
+    get sessionsDirectory() {
+        return path.join(this.storageRoot, 'sessions');
+    }
+    filePathFor(sessionId) {
+        return path.join(this.sessionsDirectory, `${sessionId}.json`);
+    }
+    async save(session) {
+        await mkdir(this.sessionsDirectory, { recursive: true });
+        const document = { session: session.toJSON() };
+        await writeFile(this.filePathFor(session.sessionId), JSON.stringify(document, null, 2), 'utf8');
+        return session;
+    }
+    async get(sessionId) {
+        try {
+            const raw = await readFile(this.filePathFor(sessionId), 'utf8');
+            const parsed = JSON.parse(raw);
+            return Session.fromJSON('session' in parsed ? parsed.session : parsed);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return null;
+            }
+            throw error;
+        }
+    }
+    async require(sessionId) {
+        const session = await this.get(sessionId);
+        if (!session) {
+            throw new Error(`Session not found: ${sessionId}`);
+        }
+        return session;
+    }
+    async list() {
+        await mkdir(this.sessionsDirectory, { recursive: true });
+        const entries = await readdir(this.sessionsDirectory, { withFileTypes: true });
+        const sessions = await Promise.all(entries
+            .filter((entry) => entry.isFile() && entry.name.endsWith('.json'))
+            .map(async (entry) => {
+            const sessionId = entry.name.replace(/\.json$/u, '');
+            return this.get(sessionId);
+        }));
+        return sessions
+            .filter((session) => Boolean(session))
+            .sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
+    }
+}
+//# sourceMappingURL=SessionRepository.js.map

package/dist/src/session/SessionRepository.js.map

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

package/dist/src/session/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./SessionRepository.js";
+export * from "./SessionManager.js";

package/dist/src/session/index.js

@@ -0,0 +1,3 @@
+export * from "./SessionRepository.js";
+export * from "./SessionManager.js";
+//# sourceMappingURL=index.js.map

package/dist/src/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/session/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC"}

package/dist/src/shared/clock.d.ts

@@ -0,0 +1,4 @@
+export declare const systemClock: {
+    now(): Date;
+    nowIso(): string;
+};

package/dist/src/shared/clock.js

@@ -0,0 +1,9 @@
+export const systemClock = {
+    now() {
+        return new Date();
+    },
+    nowIso() {
+        return new Date().toISOString();
+    },
+};
+//# sourceMappingURL=clock.js.map

package/dist/src/shared/clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.js","sourceRoot":"","sources":["../../../src/shared/clock.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,GAAG;QACD,OAAO,IAAI,IAAI,EAAE,CAAC;IACpB,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAClC,CAAC;CACF,CAAC"}

package/dist/src/shared/contracts.d.ts

@@ -0,0 +1,254 @@
+export type Role = "system" | "user" | "assistant";
+export type RunMode = "direct" | "orchestrated";
+export type RunStatus = "created" | "planned" | "running" | "merged" | "validated" | "completed" | "failed" | "partial";
+export interface ProviderRef {
+    provider: string;
+    providerSessionId: string;
+    workingDirectory: string;
+    lastUsedAt: string;
+}
+export interface SessionTurnData {
+    turnId: string;
+    sessionId: string;
+    role: Role;
+    content: string;
+    artifactIds: string[];
+    createdAt: string;
+}
+export interface SessionData {
+    sessionId: string;
+    title: string;
+    status?: string;
+    createdAt: string;
+    updatedAt: string;
+    providerRefs: ProviderRef[];
+    turns: SessionTurnData[];
+}
+export interface FileRef {
+    path: string;
+    absolutePath?: string;
+    purpose: string;
+    checksum?: string;
+    content?: string;
+}
+export interface DiffRef {
+    path: string;
+    summary?: string;
+    content?: string;
+}
+export interface LogRef {
+    path: string;
+    source: string;
+    capturedAt: string;
+    content?: string;
+}
+export interface ContextBundleData {
+    contextId: string;
+    runId: string | null;
+    summary: string;
+    files: FileRef[];
+    diffs: DiffRef[];
+    logs: LogRef[];
+    metadata: Record<string, unknown>;
+}
+export interface ProviderCallPlan {
+    provider: string;
+    prompt: string;
+    sessionHint?: ProviderRef | null;
+    timeoutMs?: number;
+    mode: RunMode;
+}
+export interface UsageData {
+    inputTokens?: number | null;
+    outputTokens?: number | null;
+    costUsd?: number | null;
+    latencyMs?: number | null;
+}
+export interface ExternalRef {
+    system: string;
+    id: string;
+    scope?: string;
+}
+export interface ProviderResponseData {
+    responseId: string;
+    taskId: string;
+    provider: string;
+    rawText?: string;
+    rawJson?: unknown;
+    rawTextRef?: string | null;
+    rawJsonRef?: string | null;
+    usage?: UsageData | null;
+    latencyMs?: number;
+    externalRefs: ExternalRef[];
+    citations?: CitationData[];
+    isError?: boolean;
+    subtype?: string | null;
+}
+export interface ConfidenceScoreData {
+    level: "low" | "medium" | "high";
+    reason?: string | null;
+}
+export interface CitationData {
+    kind: string;
+    label?: string | null;
+    pathOrUrl?: string | null;
+    line?: number | null;
+}
+export interface NormalizedResponseData {
+    normalizedResponseId: string;
+    taskId: string;
+    provider: string;
+    summary: string;
+    findings: string[];
+    suggestions: string[];
+    citations: CitationData[];
+    confidence: ConfidenceScoreData;
+}
+export interface RunTaskData {
+    taskId: string;
+    runId: string;
+    taskKind: string;
+    role: string;
+    provider?: string | null;
+    dependsOn: string[];
+    status: RunStatus | "queued";
+    prompt?: string;
+    summary?: string;
+}
+export interface TaskResultData {
+    resultId: string;
+    taskId: string;
+    summary: string;
+    findings: string[];
+    citations: CitationData[];
+    confidence: ConfidenceScoreData;
+    sourceArtifactIds: string[];
+}
+export interface ComparisonReportData {
+    reportId: string | null;
+    runId: string | null;
+    topic: string;
+    responseIds: string[];
+    agreements: string[];
+    differences: string[];
+    recommendation: string | null;
+}
+export interface RunData {
+    runId: string;
+    sessionId: string;
+    command: string;
+    mode: RunMode;
+    status: RunStatus;
+    planVersion?: string;
+    finalSummary?: string;
+    validationStatus?: string;
+    tasks: RunTaskData[];
+    taskResults: TaskResultData[];
+    contextBundles?: ContextBundleData[];
+    providerResponses?: ProviderResponseData[];
+    normalizedResponses?: NormalizedResponseData[];
+    comparisonReport?: ComparisonReportData | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ArtifactData {
+    artifactId: string;
+    kind: string;
+    path: string;
+    sessionId?: string | null;
+    runId?: string | null;
+    turnId?: string | null;
+    taskId?: string | null;
+    createdAt: string;
+}
+export interface SessionManagerPort {
+    startSession(input: {
+        title?: string;
+    }): Promise<SessionData>;
+    loadSession(sessionId: string): Promise<SessionData | null>;
+    appendTurn(input: {
+        sessionId: string;
+        role: Role;
+        content: string;
+        artifactIds?: string[];
+    }): Promise<SessionData>;
+    updateProviderRef(input: {
+        sessionId: string;
+        providerRef: ProviderRef;
+    }): Promise<SessionData>;
+}
+export interface RunCoordinatorPort {
+    startRun(input: {
+        sessionId: string;
+        command: string;
+        mode: RunMode;
+    }): Promise<RunData>;
+    attachContextBundle(input: {
+        runId: string;
+        contextBundle: ContextBundleData;
+    }): Promise<RunData>;
+    appendTask(input: {
+        runId: string;
+        taskKind: string;
+        role: string;
+        provider?: string | null;
+        dependsOn?: string[];
+        prompt?: string;
+    }): Promise<RunTaskData>;
+    appendTaskResult(input: {
+        runId: string;
+        taskId: string;
+        summary: string;
+        findings: string[];
+        citations?: CitationData[];
+        confidence: ConfidenceScoreData;
+        sourceArtifactIds?: string[];
+        providerResponse?: ProviderResponseData;
+        normalizedResponse?: NormalizedResponseData;
+    }): Promise<RunData>;
+    finalizeRun(input: {
+        runId: string;
+        finalSummary: string;
+        validationStatus: string;
+        comparisonReport?: ComparisonReportData | null;
+    }): Promise<RunData>;
+    markRunFailed(input: {
+        runId: string;
+        errorMessage: string;
+    }): Promise<RunData>;
+    loadRun(runId: string): Promise<RunData | null>;
+}
+export interface ArtifactRepositoryPort {
+    saveArtifact(input: {
+        kind: string;
+        runId?: string | null;
+        sessionId?: string | null;
+        turnId?: string | null;
+        taskId?: string | null;
+        extension?: string;
+        content: string;
+    }): Promise<ArtifactData>;
+}
+export interface ProviderAdapterPort {
+    readonly name: string;
+    call(plan: ProviderCallPlan): Promise<ProviderResponseData>;
+}
+export interface ProviderRegistryPort {
+    list(): string[];
+    get(name?: string): ProviderAdapterPort;
+}
+export interface PlanTaskSpec {
+    taskKind: string;
+    role: string;
+    provider?: string | null;
+    prompt: string;
+    dependsOn?: string[];
+}
+export interface ValidationResult {
+    status: string;
+    notes: string[];
+}
+export interface RenderResult {
+    text: string;
+    json: Record<string, unknown>;
+}

package/dist/src/shared/contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/src/shared/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/shared/contracts.ts"],"names":[],"mappings":""}

package/dist/src/shared/errors.d.ts

@@ -0,0 +1,9 @@
+export declare class AipanelError extends Error {
+    code: string;
+    details: unknown;
+    constructor(message: string, { code, details, cause }?: {
+        code?: string;
+        details?: unknown;
+        cause?: unknown;
+    });
+}

package/dist/src/shared/errors.js

@@ -0,0 +1,11 @@
+export class AipanelError extends Error {
+    code;
+    details;
+    constructor(message, { code = "AIPANEL_ERROR", details = null, cause = null } = {}) {
+        super(message, cause ? { cause } : undefined);
+        this.name = "AipanelError";
+        this.code = code;
+        this.details = details;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/shared/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/shared/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,IAAI,CAAS;IAEb,OAAO,CAAU;IAEjB,YACE,OAAe,EACf,EAAE,IAAI,GAAG,eAAe,EAAE,OAAO,GAAG,IAAI,EAAE,KAAK,GAAG,IAAI,KAA4D,EAAE;QAEpH,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF"}

package/dist/src/shared/file-system.d.ts

@@ -0,0 +1,8 @@
+export declare function ensureDirectory(path: string): Promise<void>;
+export declare function ensureParentDirectory(path: string): Promise<void>;
+export declare function readText(path: string, encoding?: BufferEncoding): Promise<string>;
+export declare function writeText(path: string, contents: string, encoding?: BufferEncoding): Promise<void>;
+export declare function readJson<T>(path: string): Promise<T>;
+export declare function writeJson(path: string, value: unknown): Promise<void>;
+export declare function pathExists(path: string): Promise<boolean>;
+export declare function listDirectory(path: string): Promise<string[]>;

package/dist/src/shared/file-system.js

@@ -0,0 +1,36 @@
+import { access, mkdir, readdir, readFile, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+export async function ensureDirectory(path) {
+    await mkdir(path, { recursive: true });
+}
+export async function ensureParentDirectory(path) {
+    await ensureDirectory(dirname(path));
+}
+export async function readText(path, encoding = "utf8") {
+    return readFile(path, encoding);
+}
+export async function writeText(path, contents, encoding = "utf8") {
+    await ensureParentDirectory(path);
+    await writeFile(path, contents, encoding);
+}
+export async function readJson(path) {
+    const text = await readText(path, "utf8");
+    return JSON.parse(text);
+}
+export async function writeJson(path, value) {
+    const text = `${JSON.stringify(value, null, 2)}\n`;
+    await writeText(path, text, "utf8");
+}
+export async function pathExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function listDirectory(path) {
+    return readdir(path);
+}
+//# sourceMappingURL=file-system.js.map

package/dist/src/shared/file-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system.js","sourceRoot":"","sources":["../../../src/shared/file-system.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY;IAChD,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAAY;IACtD,MAAM,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,IAAY,EAAE,WAA2B,MAAM;IAC5E,OAAO,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,QAAgB,EAAE,WAA2B,MAAM;IAC/F,MAAM,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAI,IAAY;IAC5C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,KAAc;IAC1D,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;IACnD,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY;IAC9C,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;AACvB,CAAC"}

package/dist/src/shared/ids.d.ts

@@ -0,0 +1 @@
+export declare function createId(prefix?: string): string;

package/dist/src/shared/ids.js

@@ -0,0 +1,6 @@
+import { randomUUID } from "node:crypto";
+export function createId(prefix = "") {
+    const id = randomUUID();
+    return prefix ? `${prefix}_${id}` : id;
+}
+//# sourceMappingURL=ids.js.map

package/dist/src/shared/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../../src/shared/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,QAAQ,CAAC,MAAM,GAAG,EAAE;IAClC,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;IACxB,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACzC,CAAC"}

package/dist/src/usecases/CompareUseCase.d.ts

@@ -0,0 +1,6 @@
+export declare class CompareUseCase {
+    execute(): Promise<{
+        kind: "message";
+        message: string;
+    }>;
+}

package/dist/src/usecases/CompareUseCase.js

@@ -0,0 +1,9 @@
+export class CompareUseCase {
+    async execute() {
+        return {
+            kind: "message",
+            message: "compare is reserved for phase 2.",
+        };
+    }
+}
+//# sourceMappingURL=CompareUseCase.js.map

package/dist/src/usecases/CompareUseCase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompareUseCase.js","sourceRoot":"","sources":["../../../src/usecases/CompareUseCase.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,cAAc;IACzB,KAAK,CAAC,OAAO;QACX,OAAO;YACL,IAAI,EAAE,SAAkB;YACxB,OAAO,EAAE,kCAAkC;SAC5C,CAAC;IACJ,CAAC;CACF"}

package/dist/src/usecases/ConsultUseCase.d.ts

@@ -0,0 +1,48 @@
+import { ResponseNormalizer } from "../compare/ResponseNormalizer.js";
+import type { ContextCollector } from "../context/ContextCollector.js";
+import type { ArtifactRepository } from "../artifact/ArtifactRepository.js";
+import type { ProviderRegistry } from "../providers/ProviderRegistry.js";
+import type { RunCoordinator } from "../run/RunCoordinator.js";
+import type { SessionManager } from "../session/SessionManager.js";
+import { systemClock } from "../shared/clock.js";
+export interface ConsultationInput {
+    command: "consult" | "followup";
+    question: string;
+    sessionId?: string;
+    title?: string;
+    files?: string[];
+    diffs?: string[];
+    logs?: string[];
+    providerName: string;
+    timeoutMs: number;
+    cwd: string;
+}
+export interface ConsultationResult {
+    kind: "consultation";
+    sessionId: string;
+    runId: string;
+    answer: string;
+    provider: string;
+    status: "completed" | "partial";
+    validationStatus: string;
+}
+export declare class ConsultUseCase {
+    #private;
+    readonly sessionManager: SessionManager;
+    readonly runCoordinator: RunCoordinator;
+    readonly providerRegistry: ProviderRegistry;
+    readonly contextCollector: ContextCollector;
+    readonly artifactRepository: ArtifactRepository;
+    readonly responseNormalizer: ResponseNormalizer;
+    readonly clock: typeof systemClock;
+    constructor({ sessionManager, runCoordinator, providerRegistry, contextCollector, artifactRepository, responseNormalizer, clock, }: {
+        sessionManager: SessionManager;
+        runCoordinator: RunCoordinator;
+        providerRegistry: ProviderRegistry;
+        contextCollector: ContextCollector;
+        artifactRepository: ArtifactRepository;
+        responseNormalizer?: ResponseNormalizer;
+        clock?: typeof systemClock;
+    });
+    execute(input: ConsultationInput): Promise<ConsultationResult>;
+}