aipanel-cli 0.1.0

package/dist/src/domain/session.js

@@ -0,0 +1,131 @@
+import { SCHEMA_VERSION, compactObject, defaultClock, defaultIdGenerator, ensureArray, optionalProp, } from "./base.js";
+import { ProviderRef } from "./value-objects.js";
+export class SessionTurn {
+    turnId;
+    sessionId;
+    role;
+    content;
+    artifactIds;
+    createdAt;
+    constructor(props) {
+        this.turnId = props.turnId;
+        this.sessionId = props.sessionId;
+        this.role = props.role;
+        this.content = props.content;
+        this.artifactIds = ensureArray(props.artifactIds);
+        this.createdAt = props.createdAt;
+    }
+    static create(params) {
+        const clock = params.clock ?? defaultClock;
+        const idGenerator = params.idGenerator ?? defaultIdGenerator;
+        return new SessionTurn({
+            turnId: params.turnId ?? idGenerator('turn'),
+            sessionId: params.sessionId,
+            role: params.role,
+            content: params.content,
+            createdAt: params.createdAt ?? clock(),
+            ...optionalProp('artifactIds', params.artifactIds),
+        });
+    }
+    static fromJSON(input) {
+        return new SessionTurn(input);
+    }
+    toJSON() {
+        return compactObject({
+            turnId: this.turnId,
+            sessionId: this.sessionId,
+            role: this.role,
+            content: this.content,
+            artifactIds: this.artifactIds,
+            createdAt: this.createdAt,
+        });
+    }
+}
+export class Session {
+    schemaVersion;
+    sessionId;
+    title;
+    status;
+    createdAt;
+    updatedAt;
+    providerRefs;
+    turns;
+    constructor(props) {
+        this.schemaVersion = props.schemaVersion ?? SCHEMA_VERSION;
+        this.sessionId = props.sessionId;
+        this.title = props.title;
+        this.status = props.status;
+        this.createdAt = props.createdAt;
+        this.updatedAt = props.updatedAt;
+        this.providerRefs = ensureArray(props.providerRefs).map((item) => ProviderRef.from(item));
+        this.turns = ensureArray(props.turns).map((item) => SessionTurn.fromJSON(item));
+    }
+    static create(params = {}) {
+        const clock = params.clock ?? defaultClock;
+        const idGenerator = params.idGenerator ?? defaultIdGenerator;
+        const createdAt = params.createdAt ?? clock();
+        const updatedAt = params.updatedAt ?? createdAt;
+        return new Session({
+            sessionId: params.sessionId ?? idGenerator('session'),
+            title: params.title ?? 'Untitled Session',
+            status: params.status ?? 'active',
+            createdAt,
+            updatedAt,
+            providerRefs: ensureArray(params.providerRefs).map((item) => ProviderRef.from(item).toJSON()),
+            turns: ensureArray(params.turns).map((item) => item instanceof SessionTurn ? item.toJSON() : SessionTurn.fromJSON(item).toJSON()),
+        });
+    }
+    static fromJSON(input) {
+        return new Session(input);
+    }
+    appendTurn(turn, updatedAt = defaultClock()) {
+        if (turn.sessionId !== this.sessionId) {
+            throw new Error(`Session turn ${turn.turnId} does not belong to session ${this.sessionId}`);
+        }
+        this.turns.push(turn);
+        this.updatedAt = updatedAt;
+    }
+    createTurn(params) {
+        const turn = SessionTurn.create({
+            sessionId: this.sessionId,
+            role: params.role,
+            content: params.content,
+            ...(params.artifactIds ? { artifactIds: params.artifactIds } : {}),
+            ...(params.turnId ? { turnId: params.turnId } : {}),
+            ...(params.createdAt ? { createdAt: params.createdAt } : {}),
+            ...(params.clock ? { clock: params.clock } : {}),
+            ...(params.idGenerator ? { idGenerator: params.idGenerator } : {}),
+        });
+        this.appendTurn(turn, turn.createdAt);
+        return turn;
+    }
+    upsertProviderRef(providerRef, updatedAt = defaultClock()) {
+        const resolved = ProviderRef.from(providerRef);
+        const index = this.providerRefs.findIndex((item) => item.provider === resolved.provider);
+        if (index >= 0) {
+            this.providerRefs[index] = resolved;
+        }
+        else {
+            this.providerRefs.push(resolved);
+        }
+        this.updatedAt = updatedAt;
+    }
+    buildTranscript() {
+        return this.turns
+            .map((turn) => `${turn.role.toUpperCase()}: ${turn.content}`)
+            .join('\n\n');
+    }
+    toJSON() {
+        return compactObject({
+            schemaVersion: this.schemaVersion,
+            sessionId: this.sessionId,
+            title: this.title,
+            status: this.status,
+            createdAt: this.createdAt,
+            updatedAt: this.updatedAt,
+            providerRefs: this.providerRefs.map((item) => item.toJSON()),
+            turns: this.turns.map((item) => item.toJSON()),
+        });
+    }
+}
+//# sourceMappingURL=session.js.map

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

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

package/dist/src/domain/value-objects.d.ts

@@ -0,0 +1,120 @@
+import { type IsoDateString } from "./base.js";
+export interface ProviderRefProps {
+    provider: string;
+    providerSessionId: string;
+    workingDirectory?: string | null;
+    lastUsedAt?: IsoDateString | null;
+}
+export declare class ProviderRef {
+    readonly provider: string;
+    readonly providerSessionId: string;
+    readonly workingDirectory: string | null;
+    readonly lastUsedAt: IsoDateString | null;
+    constructor(props: ProviderRefProps);
+    static from(input: ProviderRef | ProviderRefProps): ProviderRef;
+    toJSON(): ProviderRefProps;
+}
+export interface UsageProps {
+    inputTokens?: number | null;
+    outputTokens?: number | null;
+    costUsd?: number | null;
+    latencyMs?: number | null;
+}
+export declare class Usage {
+    readonly inputTokens: number | null;
+    readonly outputTokens: number | null;
+    readonly costUsd: number | null;
+    readonly latencyMs: number | null;
+    constructor(props?: UsageProps);
+    static from(input: Usage | UsageProps | null | undefined): Usage | null;
+    toJSON(): UsageProps;
+}
+export interface CitationProps {
+    kind: string;
+    label?: string | null;
+    pathOrUrl?: string | null;
+    line?: number | null;
+}
+export declare class Citation {
+    readonly kind: string;
+    readonly label: string | null;
+    readonly pathOrUrl: string | null;
+    readonly line: number | null;
+    constructor(props: CitationProps);
+    static from(input: Citation | CitationProps): Citation;
+    toJSON(): CitationProps;
+}
+export interface TaskDependencyProps {
+    taskId: string;
+    dependencyTaskId: string;
+}
+export declare class TaskDependency {
+    readonly taskId: string;
+    readonly dependencyTaskId: string;
+    constructor(props: TaskDependencyProps);
+    static from(input: TaskDependency | TaskDependencyProps): TaskDependency;
+    toJSON(): TaskDependencyProps;
+}
+export interface FileRefProps {
+    path: string;
+    purpose?: string | null;
+    checksum?: string | null;
+}
+export declare class FileRef {
+    readonly path: string;
+    readonly purpose: string | null;
+    readonly checksum: string | null;
+    constructor(props: FileRefProps);
+    static from(input: FileRef | FileRefProps): FileRef;
+    toJSON(): FileRefProps;
+}
+export interface DiffRefProps {
+    path: string;
+    range?: string | null;
+    summary?: string | null;
+}
+export declare class DiffRef {
+    readonly path: string;
+    readonly range: string | null;
+    readonly summary: string | null;
+    constructor(props: DiffRefProps);
+    static from(input: DiffRef | DiffRefProps): DiffRef;
+    toJSON(): DiffRefProps;
+}
+export interface LogRefProps {
+    path: string;
+    source?: string | null;
+    capturedAt?: IsoDateString | null;
+}
+export declare class LogRef {
+    readonly path: string;
+    readonly source: string | null;
+    readonly capturedAt: IsoDateString | null;
+    constructor(props: LogRefProps);
+    static from(input: LogRef | LogRefProps): LogRef;
+    toJSON(): LogRefProps;
+}
+export interface ConfidenceScoreProps {
+    level: string;
+    reason?: string | null;
+}
+export declare class ConfidenceScore {
+    readonly level: string;
+    readonly reason: string | null;
+    constructor(props: ConfidenceScoreProps);
+    static from(input: ConfidenceScore | ConfidenceScoreProps | null | undefined): ConfidenceScore | null;
+    toJSON(): ConfidenceScoreProps;
+}
+export interface ExternalRefProps {
+    system: string;
+    id: string;
+    scope?: string | null;
+}
+export declare class ExternalRef {
+    readonly system: string;
+    readonly id: string;
+    readonly scope: string | null;
+    constructor(props: ExternalRefProps);
+    static from(input: ExternalRef | ExternalRefProps): ExternalRef;
+    toJSON(): ExternalRefProps;
+}

package/dist/src/domain/value-objects.js

@@ -0,0 +1,191 @@
+import { compactObject } from "./base.js";
+export class ProviderRef {
+    provider;
+    providerSessionId;
+    workingDirectory;
+    lastUsedAt;
+    constructor(props) {
+        this.provider = props.provider;
+        this.providerSessionId = props.providerSessionId;
+        this.workingDirectory = props.workingDirectory ?? null;
+        this.lastUsedAt = props.lastUsedAt ?? null;
+    }
+    static from(input) {
+        return input instanceof ProviderRef ? input : new ProviderRef(input);
+    }
+    toJSON() {
+        return compactObject({
+            provider: this.provider,
+            providerSessionId: this.providerSessionId,
+            workingDirectory: this.workingDirectory,
+            lastUsedAt: this.lastUsedAt,
+        });
+    }
+}
+export class Usage {
+    inputTokens;
+    outputTokens;
+    costUsd;
+    latencyMs;
+    constructor(props = {}) {
+        this.inputTokens = props.inputTokens ?? null;
+        this.outputTokens = props.outputTokens ?? null;
+        this.costUsd = props.costUsd ?? null;
+        this.latencyMs = props.latencyMs ?? null;
+    }
+    static from(input) {
+        if (!input) {
+            return null;
+        }
+        return input instanceof Usage ? input : new Usage(input);
+    }
+    toJSON() {
+        return compactObject({
+            inputTokens: this.inputTokens,
+            outputTokens: this.outputTokens,
+            costUsd: this.costUsd,
+            latencyMs: this.latencyMs,
+        });
+    }
+}
+export class Citation {
+    kind;
+    label;
+    pathOrUrl;
+    line;
+    constructor(props) {
+        this.kind = props.kind;
+        this.label = props.label ?? null;
+        this.pathOrUrl = props.pathOrUrl ?? null;
+        this.line = props.line ?? null;
+    }
+    static from(input) {
+        return input instanceof Citation ? input : new Citation(input);
+    }
+    toJSON() {
+        return compactObject({
+            kind: this.kind,
+            label: this.label,
+            pathOrUrl: this.pathOrUrl,
+            line: this.line,
+        });
+    }
+}
+export class TaskDependency {
+    taskId;
+    dependencyTaskId;
+    constructor(props) {
+        this.taskId = props.taskId;
+        this.dependencyTaskId = props.dependencyTaskId;
+    }
+    static from(input) {
+        return input instanceof TaskDependency ? input : new TaskDependency(input);
+    }
+    toJSON() {
+        return {
+            taskId: this.taskId,
+            dependencyTaskId: this.dependencyTaskId,
+        };
+    }
+}
+export class FileRef {
+    path;
+    purpose;
+    checksum;
+    constructor(props) {
+        this.path = props.path;
+        this.purpose = props.purpose ?? null;
+        this.checksum = props.checksum ?? null;
+    }
+    static from(input) {
+        return input instanceof FileRef ? input : new FileRef(input);
+    }
+    toJSON() {
+        return compactObject({
+            path: this.path,
+            purpose: this.purpose,
+            checksum: this.checksum,
+        });
+    }
+}
+export class DiffRef {
+    path;
+    range;
+    summary;
+    constructor(props) {
+        this.path = props.path;
+        this.range = props.range ?? null;
+        this.summary = props.summary ?? null;
+    }
+    static from(input) {
+        return input instanceof DiffRef ? input : new DiffRef(input);
+    }
+    toJSON() {
+        return compactObject({
+            path: this.path,
+            range: this.range,
+            summary: this.summary,
+        });
+    }
+}
+export class LogRef {
+    path;
+    source;
+    capturedAt;
+    constructor(props) {
+        this.path = props.path;
+        this.source = props.source ?? null;
+        this.capturedAt = props.capturedAt ?? null;
+    }
+    static from(input) {
+        return input instanceof LogRef ? input : new LogRef(input);
+    }
+    toJSON() {
+        return compactObject({
+            path: this.path,
+            source: this.source,
+            capturedAt: this.capturedAt,
+        });
+    }
+}
+export class ConfidenceScore {
+    level;
+    reason;
+    constructor(props) {
+        this.level = props.level;
+        this.reason = props.reason ?? null;
+    }
+    static from(input) {
+        if (!input) {
+            return null;
+        }
+        return input instanceof ConfidenceScore ? input : new ConfidenceScore(input);
+    }
+    toJSON() {
+        return compactObject({
+            level: this.level,
+            reason: this.reason,
+        });
+    }
+}
+export class ExternalRef {
+    system;
+    id;
+    scope;
+    constructor(props) {
+        this.system = props.system;
+        this.id = props.id;
+        this.scope = props.scope ?? null;
+    }
+    static from(input) {
+        return input instanceof ExternalRef ? input : new ExternalRef(input);
+    }
+    toJSON() {
+        return compactObject({
+            system: this.system,
+            id: this.id,
+            scope: this.scope,
+        });
+    }
+}
+//# sourceMappingURL=value-objects.js.map

package/dist/src/domain/value-objects.js.map

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

package/dist/src/orchestrator/PlanBuilder.d.ts

@@ -0,0 +1,6 @@
+import type { ContextBundleData, PlanTaskSpec } from "../shared/contracts.js";
+export declare class PlanBuilder {
+    #private;
+    buildDirectPlan(question: string, contextBundle: ContextBundleData, provider: string): PlanTaskSpec[];
+    buildDebugPlan(question: string, contextBundle: ContextBundleData, provider: string): PlanTaskSpec[];
+}

package/dist/src/orchestrator/PlanBuilder.js

@@ -0,0 +1,59 @@
+export class PlanBuilder {
+    buildDirectPlan(question, contextBundle, provider) {
+        return [
+            {
+                taskKind: "consultation",
+                role: "provider-reviewer",
+                provider,
+                prompt: this.#buildPrompt("Consultation", question, contextBundle),
+            },
+        ];
+    }
+    buildDebugPlan(question, contextBundle, provider) {
+        return [
+            {
+                taskKind: "root-cause-analysis",
+                role: "planner",
+                provider,
+                prompt: this.#buildPrompt("Root Cause Analysis", `Find the most likely root causes for the following problem.\n\n${question}`, contextBundle),
+            },
+            {
+                taskKind: "risk-review",
+                role: "provider-reviewer",
+                provider,
+                prompt: this.#buildPrompt("Risk Review", `Review the implementation and identify likely regressions, edge cases, and hidden risks.\n\n${question}`, contextBundle),
+            },
+            {
+                taskKind: "fix-proposal",
+                role: "provider-reviewer",
+                provider,
+                prompt: this.#buildPrompt("Fix Proposal", `Propose a pragmatic fix plan with the smallest safe change set.\n\n${question}`, contextBundle),
+            },
+        ];
+    }
+    #buildPrompt(label, question, contextBundle) {
+        const sections = [
+            `Task: ${label}`,
+            `Question:\n${question.trim()}`,
+            `Context Summary:\n${contextBundle.summary}`,
+        ];
+        if ((contextBundle.files?.length ?? 0) > 0) {
+            sections.push(contextBundle.files
+                .map((file) => `File: ${file.path}\n${file.content ?? ""}`.trim())
+                .join("\n\n"));
+        }
+        if ((contextBundle.diffs?.length ?? 0) > 0) {
+            sections.push(contextBundle.diffs
+                .map((diff) => `Diff: ${diff.path}\n${diff.content ?? ""}`.trim())
+                .join("\n\n"));
+        }
+        if ((contextBundle.logs?.length ?? 0) > 0) {
+            sections.push(contextBundle.logs
+                .map((log) => `Log: ${log.path}\n${log.content ?? ""}`.trim())
+                .join("\n\n"));
+        }
+        sections.push("Return a concise answer with findings, reasoning, and a short actionable recommendation.");
+        return sections.join("\n\n");
+    }
+}
+//# sourceMappingURL=PlanBuilder.js.map

package/dist/src/orchestrator/PlanBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlanBuilder.js","sourceRoot":"","sources":["../../../src/orchestrator/PlanBuilder.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,WAAW;IACtB,eAAe,CAAC,QAAgB,EAAE,aAAgC,EAAE,QAAgB;QAClF,OAAO;YACL;gBACE,QAAQ,EAAE,cAAc;gBACxB,IAAI,EAAE,mBAAmB;gBACzB,QAAQ;gBACR,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,cAAc,EAAE,QAAQ,EAAE,aAAa,CAAC;aACnE;SACF,CAAC;IACJ,CAAC;IAED,cAAc,CAAC,QAAgB,EAAE,aAAgC,EAAE,QAAgB;QACjF,OAAO;YACL;gBACE,QAAQ,EAAE,qBAAqB;gBAC/B,IAAI,EAAE,SAAS;gBACf,QAAQ;gBACR,MAAM,EAAE,IAAI,CAAC,YAAY,CACvB,qBAAqB,EACrB,kEAAkE,QAAQ,EAAE,EAC5E,aAAa,CACd;aACF;YACD;gBACE,QAAQ,EAAE,aAAa;gBACvB,IAAI,EAAE,mBAAmB;gBACzB,QAAQ;gBACR,MAAM,EAAE,IAAI,CAAC,YAAY,CACvB,aAAa,EACb,+FAA+F,QAAQ,EAAE,EACzG,aAAa,CACd;aACF;YACD;gBACE,QAAQ,EAAE,cAAc;gBACxB,IAAI,EAAE,mBAAmB;gBACzB,QAAQ;gBACR,MAAM,EAAE,IAAI,CAAC,YAAY,CACvB,cAAc,EACd,sEAAsE,QAAQ,EAAE,EAChF,aAAa,CACd;aACF;SACF,CAAC;IACJ,CAAC;IAED,YAAY,CAAC,KAAa,EAAE,QAAgB,EAAE,aAAgC;QAC5E,MAAM,QAAQ,GAAG;YACf,SAAS,KAAK,EAAE;YAChB,cAAc,QAAQ,CAAC,IAAI,EAAE,EAAE;YAC/B,qBAAqB,aAAa,CAAC,OAAO,EAAE;SAC7C,CAAC;QAEF,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3C,QAAQ,CAAC,IAAI,CACX,aAAa,CAAC,KAAK;iBAChB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;iBACjE,IAAI,CAAC,MAAM,CAAC,CAChB,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3C,QAAQ,CAAC,IAAI,CACX,aAAa,CAAC,KAAK;iBAChB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;iBACjE,IAAI,CAAC,MAAM,CAAC,CAChB,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1C,QAAQ,CAAC,IAAI,CACX,aAAa,CAAC,IAAI;iBACf,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;iBAC7D,IAAI,CAAC,MAAM,CAAC,CAChB,CAAC;QACJ,CAAC;QAED,QAAQ,CAAC,IAAI,CACX,0FAA0F,CAC3F,CAAC;QAEF,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;CACF"}

package/dist/src/orchestrator/ResultMerger.d.ts

@@ -0,0 +1,10 @@
+import type { ComparisonReportData, NormalizedResponseData, RunData } from "../shared/contracts.js";
+import type { ComparisonEngine } from "../compare/ComparisonEngine.js";
+export declare class ResultMerger {
+    #private;
+    constructor(comparisonEngine: ComparisonEngine);
+    merge(topic: string, run: RunData, normalizedResponses: NormalizedResponseData[]): {
+        finalSummary: string;
+        comparisonReport: ComparisonReportData;
+    };
+}

package/dist/src/orchestrator/ResultMerger.js

@@ -0,0 +1,19 @@
+export class ResultMerger {
+    #comparisonEngine;
+    constructor(comparisonEngine) {
+        this.#comparisonEngine = comparisonEngine;
+    }
+    merge(topic, run, normalizedResponses) {
+        const comparisonReport = this.#comparisonEngine.compare(topic, normalizedResponses);
+        comparisonReport.runId = run.runId;
+        const parts = normalizedResponses.map((response) => {
+            const findings = response.findings.slice(0, 3).join("; ");
+            return `[${response.provider}/${response.taskId}] ${response.summary}${findings ? ` Findings: ${findings}` : ""}`;
+        });
+        return {
+            finalSummary: parts.join("\n"),
+            comparisonReport,
+        };
+    }
+}
+//# sourceMappingURL=ResultMerger.js.map

package/dist/src/orchestrator/ResultMerger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResultMerger.js","sourceRoot":"","sources":["../../../src/orchestrator/ResultMerger.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,YAAY;IACd,iBAAiB,CAAmB;IAE7C,YAAY,gBAAkC;QAC5C,IAAI,CAAC,iBAAiB,GAAG,gBAAgB,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,KAAa,EAAE,GAAY,EAAE,mBAA6C;QAI9E,MAAM,gBAAgB,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC;QACpF,gBAAgB,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;QAEnC,MAAM,KAAK,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;YACjD,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1D,OAAO,IAAI,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,cAAc,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACpH,CAAC,CAAC,CAAC;QAEH,OAAO;YACL,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;YAC9B,gBAAgB;SACjB,CAAC;IACJ,CAAC;CACF"}

package/dist/src/orchestrator/TaskExecutor.d.ts

@@ -0,0 +1,20 @@
+import type { ArtifactRepositoryPort, NormalizedResponseData, PlanTaskSpec, ProviderRegistryPort, RunCoordinatorPort, RunData, SessionData } from "../shared/contracts.js";
+import type { ResponseNormalizer } from "../compare/ResponseNormalizer.js";
+export interface TaskExecutorDependencies {
+    providerRegistry: ProviderRegistryPort;
+    artifactRepository: ArtifactRepositoryPort;
+    responseNormalizer: ResponseNormalizer;
+    runCoordinator: RunCoordinatorPort;
+}
+export declare class TaskExecutor {
+    #private;
+    constructor(dependencies: TaskExecutorDependencies);
+    executePlan(input: {
+        session: SessionData;
+        run: RunData;
+        taskSpecs: PlanTaskSpec[];
+    }): Promise<{
+        run: RunData;
+        normalizedResponses: NormalizedResponseData[];
+    }>;
+}

package/dist/src/orchestrator/TaskExecutor.js

@@ -0,0 +1,81 @@
+export class TaskExecutor {
+    #providerRegistry;
+    #artifactRepository;
+    #responseNormalizer;
+    #runCoordinator;
+    constructor(dependencies) {
+        this.#providerRegistry = dependencies.providerRegistry;
+        this.#artifactRepository = dependencies.artifactRepository;
+        this.#responseNormalizer = dependencies.responseNormalizer;
+        this.#runCoordinator = dependencies.runCoordinator;
+    }
+    async executePlan(input) {
+        const normalizedResponses = [];
+        let currentRun = input.run;
+        for (const spec of input.taskSpecs) {
+            const task = await this.#runCoordinator.appendTask({
+                runId: currentRun.runId,
+                taskKind: spec.taskKind,
+                role: spec.role,
+                provider: spec.provider ?? null,
+                dependsOn: spec.dependsOn ?? [],
+                prompt: spec.prompt,
+            });
+            const { updatedRun, normalizedResponse } = await this.#executeTask({
+                session: input.session,
+                run: currentRun,
+                task,
+                prompt: spec.prompt,
+            });
+            currentRun = updatedRun;
+            normalizedResponses.push(normalizedResponse);
+        }
+        return { run: currentRun, normalizedResponses };
+    }
+    async #executeTask(input) {
+        const provider = input.task.provider ?? "claude-code";
+        const adapter = this.#providerRegistry.get(provider);
+        const providerRef = input.session.providerRefs.find((ref) => ref.provider === provider) ?? null;
+        const providerResponse = await adapter.call({
+            provider,
+            prompt: input.prompt,
+            sessionHint: providerRef,
+            mode: input.run.mode,
+        });
+        const rawTextArtifact = await this.#artifactRepository.saveArtifact({
+            kind: "provider-raw-text",
+            runId: input.run.runId,
+            sessionId: input.session.sessionId,
+            taskId: input.task.taskId,
+            extension: "txt",
+            content: providerResponse.rawText ?? "",
+        });
+        const rawJsonArtifact = await this.#artifactRepository.saveArtifact({
+            kind: "provider-raw-json",
+            runId: input.run.runId,
+            sessionId: input.session.sessionId,
+            taskId: input.task.taskId,
+            extension: "json",
+            content: JSON.stringify(providerResponse.rawJson ?? {}, null, 2),
+        });
+        providerResponse.rawTextRef = rawTextArtifact.path;
+        providerResponse.rawJsonRef = rawJsonArtifact.path;
+        const normalizedResponse = this.#responseNormalizer.normalize({
+            taskId: input.task.taskId,
+            providerResponse,
+        });
+        const updatedRun = await this.#runCoordinator.appendTaskResult({
+            runId: input.run.runId,
+            taskId: input.task.taskId,
+            summary: normalizedResponse.summary,
+            findings: normalizedResponse.findings,
+            citations: normalizedResponse.citations,
+            confidence: normalizedResponse.confidence,
+            sourceArtifactIds: [rawTextArtifact.artifactId, rawJsonArtifact.artifactId],
+            providerResponse,
+            normalizedResponse,
+        });
+        return { updatedRun, normalizedResponse };
+    }
+}
+//# sourceMappingURL=TaskExecutor.js.map