duocode 0.1.0

package/dist/duo/duo_session.js

@@ -0,0 +1,127 @@
+const MODE_CYCLE = ["code", "plan", "execute", "debug"];
+export const MODE_LABELS = {
+    code: "Code",
+    plan: "Plan",
+    execute: "Execute",
+    debug: "Debug",
+};
+export const MODE_DESCRIPTIONS = {
+    code: "Full pipeline: architect plan → review → executor",
+    plan: "Architect only — generates plan, stops before execution",
+    execute: "Full pipeline, no pauses — auto-confirms everything",
+    debug: "Debug-focused — wraps prompt for error analysis and fixes",
+};
+const DEFAULT_MAX_CONTEXT_TURNS = 3;
+const DEFAULT_MAX_PLAN_CHARS = 2000;
+const DEFAULT_MAX_OUTPUT_CHARS = 3000;
+function truncate(text, maxChars) {
+    if (maxChars <= 0)
+        return "";
+    if (text.length <= maxChars)
+        return text;
+    const marker = "[...truncated] ";
+    const budget = Math.max(0, maxChars - marker.length);
+    return marker + text.slice(text.length - budget);
+}
+export class DuoSession {
+    turns = [];
+    totalCostUsd = 0;
+    _assignment = null;
+    _gradingEnabled = true;
+    _autoConfirm = false;
+    _mode = "code";
+    _pendingPlan = null;
+    addTurn(turn) {
+        this.turns.push(turn);
+        this.totalCostUsd += turn.costUsd;
+    }
+    clear() {
+        this.turns = [];
+        this.totalCostUsd = 0;
+        this._assignment = null;
+        this._pendingPlan = null;
+        // Note: _mode and _gradingEnabled are intentionally NOT reset by clear().
+    }
+    getTurnCount() {
+        return this.turns.length;
+    }
+    getTotalCost() {
+        return this.totalCostUsd;
+    }
+    getTurns() {
+        return this.turns;
+    }
+    get assignment() {
+        return this._assignment;
+    }
+    set assignment(value) {
+        this._assignment = value;
+    }
+    get gradingEnabled() {
+        return this._gradingEnabled;
+    }
+    toggleGrading() {
+        this._gradingEnabled = !this._gradingEnabled;
+        return this._gradingEnabled;
+    }
+    get autoConfirm() {
+        return this._autoConfirm;
+    }
+    toggleAutoConfirm() {
+        this._autoConfirm = !this._autoConfirm;
+        return this._autoConfirm;
+    }
+    get mode() {
+        return this._mode;
+    }
+    cycleMode() {
+        const idx = MODE_CYCLE.indexOf(this._mode);
+        this._mode = MODE_CYCLE[(idx + 1) % MODE_CYCLE.length];
+        return this._mode;
+    }
+    setMode(mode) {
+        this._mode = mode;
+    }
+    get pendingPlan() {
+        return this._pendingPlan;
+    }
+    storePlan(plan) {
+        this._pendingPlan = plan;
+    }
+    clearPendingPlan() {
+        this._pendingPlan = null;
+    }
+    buildContext(maxTurns = DEFAULT_MAX_CONTEXT_TURNS, maxPlanChars = DEFAULT_MAX_PLAN_CHARS, maxOutputChars = DEFAULT_MAX_OUTPUT_CHARS) {
+        if (this.turns.length === 0)
+            return "";
+        const recentTurns = this.turns.slice(-maxTurns);
+        const parts = ["## Previous conversation\n"];
+        for (let i = 0; i < recentTurns.length; i++) {
+            const turn = recentTurns[i];
+            const turnIndex = this.turns.length - recentTurns.length + i + 1;
+            parts.push(`### Turn ${turnIndex}: "${turn.prompt}"`);
+            parts.push(`**Architect plan:**\n${truncate(turn.architectPlan, maxPlanChars)}`);
+            parts.push(`**Executor output:**\n${truncate(turn.executorOutput, maxOutputChars)}`);
+            parts.push("");
+        }
+        return parts.join("\n");
+    }
+    buildHistorySummary() {
+        if (this.turns.length === 0)
+            return "No conversation history.";
+        const lines = [];
+        for (let i = 0; i < this.turns.length; i++) {
+            const turn = this.turns[i];
+            const promptPreview = turn.prompt.length > 60
+                ? turn.prompt.slice(0, 57) + "..."
+                : turn.prompt;
+            const grade = turn.grading
+                ? ` | grade: ${turn.grading.compositeScore.toFixed(2)}/5`
+                : "";
+            lines.push(`  #${i + 1}  "${promptPreview}"  ($${turn.costUsd.toFixed(4)}, ${turn.durationMs}ms${grade})`);
+        }
+        lines.push(`\n  Total: ${this.turns.length} turns, $${this.totalCostUsd.toFixed(4)}`);
+        return lines.join("\n");
+    }
+}
+//# sourceMappingURL=duo_session.js.map

package/dist/duo/duo_session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duo_session.js","sourceRoot":"","sources":["../../src/duo/duo_session.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,GAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AAE3E,MAAM,CAAC,MAAM,WAAW,GAAoC;IAC1D,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;CACf,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAoC;IAChE,IAAI,EAAE,mDAAmD;IACzD,IAAI,EAAE,yDAAyD;IAC/D,OAAO,EAAE,qDAAqD;IAC9D,KAAK,EAAE,2DAA2D;CACnE,CAAC;AAmBF,MAAM,yBAAyB,GAAG,CAAC,CAAC;AACpC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AACpC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAEtC,SAAS,QAAQ,CAAC,IAAY,EAAE,QAAgB;IAC9C,IAAI,QAAQ,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAC7B,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,MAAM,GAAG,iBAAiB,CAAC;IACjC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACrD,OAAO,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,OAAO,UAAU;IACb,KAAK,GAAuB,EAAE,CAAC;IAC/B,YAAY,GAAG,CAAC,CAAC;IACjB,WAAW,GAA6B,IAAI,CAAC;IAC7C,eAAe,GAAG,IAAI,CAAC;IACvB,YAAY,GAAG,KAAK,CAAC;IACrB,KAAK,GAAoB,MAAM,CAAC;IAChC,YAAY,GAAuB,IAAI,CAAC;IAEhD,OAAO,CAAC,IAAsB;QAC5B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,OAAO,CAAC;IACpC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,0EAA0E;IAC5E,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,IAAI,UAAU,CAAC,KAA+B;QAC5C,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED,aAAa;QACX,IAAI,CAAC,eAAe,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC;QAC7C,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,iBAAiB;QACf,IAAI,CAAC,YAAY,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC;QACvC,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,SAAS;QACP,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,OAAO,CAAC,IAAqB;QAC3B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,SAAS,CAAC,IAAiB;QACzB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED,gBAAgB;QACd,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED,YAAY,CACV,QAAQ,GAAG,yBAAyB,EACpC,YAAY,GAAG,sBAAsB,EACrC,cAAc,GAAG,wBAAwB;QAEzC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEvC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC;QAChD,MAAM,KAAK,GAAa,CAAC,4BAA4B,CAAC,CAAC;QAEvD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC5C,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC;YACjE,KAAK,CAAC,IAAI,CAAC,YAAY,SAAS,MAAM,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;YACtD,KAAK,CAAC,IAAI,CAAC,wBAAwB,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC;YACjF,KAAK,CAAC,IAAI,CAAC,yBAAyB,QAAQ,CAAC,IAAI,CAAC,cAAc,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC;YACrF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,mBAAmB;QACjB,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,0BAA0B,CAAC;QAE/D,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC3B,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,EAAE;gBAC3C,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK;gBAClC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;YAChB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO;gBACxB,CAAC,CAAC,aAAa,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;gBACzD,CAAC,CAAC,EAAE,CAAC;YACP,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,aAAa,QAAQ,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,UAAU,KAAK,KAAK,GAAG,CAAC,CAAC;QAC7G,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,KAAK,CAAC,MAAM,YAAY,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACtF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF"}

package/dist/duo/duo_types.d.ts

@@ -0,0 +1,168 @@
+import { z } from "zod";
+import type { ModelProfile } from "../providers/base.js";
+import type { FileChange } from "../tools/tool_types.js";
+export type DuoRole = "architect" | "executor";
+export declare const ARCHITECT_CAPABILITIES: readonly ["deep_reasoning", "architecture_design", "api_design", "data_modeling", "security_analysis", "code_review"];
+export declare const EXECUTOR_CAPABILITIES: readonly ["code_generation", "code_refactoring", "test_generation", "bug_diagnosis", "performance_optimization", "documentation"];
+export type ArchitectCapability = (typeof ARCHITECT_CAPABILITIES)[number];
+export type ExecutorCapability = (typeof EXECUTOR_CAPABILITIES)[number];
+export interface DuoPairSlot {
+    profile: ModelProfile;
+    role: DuoRole;
+    roleScore: number;
+    reasons: string[];
+}
+export interface DuoPairAssignment {
+    architect: DuoPairSlot;
+    executor: DuoPairSlot;
+    pairScore: number;
+    sameModel: boolean;
+    rationale: string;
+}
+export declare const GRADING_DIMENSIONS: readonly ["correctness", "security", "efficiency", "robustness", "maintainability", "usability"];
+export type GradingDimension = (typeof GRADING_DIMENSIONS)[number];
+export declare const DIMENSION_WEIGHTS: Record<GradingDimension, number>;
+export interface DimensionScore {
+    dimension: GradingDimension;
+    score: number;
+    reasoning: string;
+}
+export interface GradingResult {
+    model: string;
+    role: DuoRole;
+    dimensions: DimensionScore[];
+    compositeScore: number;
+    gradedBy: string;
+    judgeRationale?: string;
+    taskId?: string;
+}
+export declare const DEFAULT_ELO = 1500;
+export declare const DEFAULT_K_FACTOR = 32;
+export interface EloRecord {
+    model: string;
+    role: DuoRole;
+    capabilityBucket: string;
+    elo: number;
+    matchCount: number;
+}
+export interface EloMatchResult {
+    winnerModel: string;
+    loserModel: string;
+    role: DuoRole;
+    capabilityBucket: string;
+    isDraw: boolean;
+    scoreDelta: number;
+}
+export interface CostEstimate {
+    architectModel: string;
+    executorModel: string;
+    architectCostUsd: number;
+    executorCostUsd: number;
+    totalEstimatedCostUsd: number;
+    estimatedInputTokens: number;
+    estimatedOutputTokens: number;
+}
+export type ConfirmationAction = "proceed" | "abort" | "pick-architect" | "pick-executor";
+export type ConfirmationCallback = (estimate: CostEstimate) => Promise<ConfirmationAction>;
+export interface ModelPickerOption {
+    model: string;
+    provider: string;
+    roleAffinity: number;
+    estimatedCostUsd: number;
+    isCurrent: boolean;
+}
+export type ModelPickerCallback = (role: DuoRole, options: ModelPickerOption[], currentModel: string) => Promise<string | null>;
+export type ArchitectReviewCallback = (architectOutput: string) => Promise<boolean>;
+export interface DuoPairRequest {
+    prompt: string;
+    conversationContext?: string;
+    preferredArchitect?: string;
+    preferredExecutor?: string;
+    judgeModel?: string;
+    enableGrading?: boolean;
+    requireConfirmation?: boolean;
+    architectOnly?: boolean;
+    precomputedPlan?: string;
+    /** Enable agentic tool use in the executor phase */
+    enableTools?: boolean;
+    /** Project root for file operations (required when enableTools is true) */
+    projectRoot?: string;
+    /** Pre-built project context (file tree + relevant file contents) */
+    projectContext?: string;
+    /** Files included in the project context (for display) */
+    includedFiles?: Array<{
+        path: string;
+        reason: string;
+    }>;
+}
+export declare const DuoPairRequestSchema: z.ZodObject<{
+    prompt: z.ZodString;
+    conversationContext: z.ZodOptional<z.ZodString>;
+    preferredArchitect: z.ZodOptional<z.ZodString>;
+    preferredExecutor: z.ZodOptional<z.ZodString>;
+    judgeModel: z.ZodOptional<z.ZodString>;
+    enableGrading: z.ZodOptional<z.ZodBoolean>;
+    requireConfirmation: z.ZodOptional<z.ZodBoolean>;
+    architectOnly: z.ZodOptional<z.ZodBoolean>;
+    precomputedPlan: z.ZodOptional<z.ZodString>;
+    enableTools: z.ZodOptional<z.ZodBoolean>;
+    projectRoot: z.ZodOptional<z.ZodString>;
+    projectContext: z.ZodOptional<z.ZodString>;
+    includedFiles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        reason: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        reason: string;
+    }, {
+        path: string;
+        reason: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    prompt: string;
+    preferredArchitect?: string | undefined;
+    preferredExecutor?: string | undefined;
+    conversationContext?: string | undefined;
+    judgeModel?: string | undefined;
+    enableGrading?: boolean | undefined;
+    requireConfirmation?: boolean | undefined;
+    architectOnly?: boolean | undefined;
+    precomputedPlan?: string | undefined;
+    enableTools?: boolean | undefined;
+    projectRoot?: string | undefined;
+    projectContext?: string | undefined;
+    includedFiles?: {
+        path: string;
+        reason: string;
+    }[] | undefined;
+}, {
+    prompt: string;
+    preferredArchitect?: string | undefined;
+    preferredExecutor?: string | undefined;
+    conversationContext?: string | undefined;
+    judgeModel?: string | undefined;
+    enableGrading?: boolean | undefined;
+    requireConfirmation?: boolean | undefined;
+    architectOnly?: boolean | undefined;
+    precomputedPlan?: string | undefined;
+    enableTools?: boolean | undefined;
+    projectRoot?: string | undefined;
+    projectContext?: string | undefined;
+    includedFiles?: {
+        path: string;
+        reason: string;
+    }[] | undefined;
+}>;
+export interface DuoPipelineResult {
+    assignment: DuoPairAssignment;
+    architectOutput: string;
+    executorOutput: string;
+    grading?: GradingResult;
+    architectGrading?: GradingResult;
+    totalCostUsd: number;
+    durationMs: number;
+    /** Files created/edited during tool execution */
+    fileChanges?: FileChange[];
+    /** Number of tool calls made during executor phase */
+    toolCallCount?: number;
+}

package/dist/duo/duo_types.js

@@ -0,0 +1,53 @@
+import { z } from "zod";
+export const ARCHITECT_CAPABILITIES = [
+    "deep_reasoning",
+    "architecture_design",
+    "api_design",
+    "data_modeling",
+    "security_analysis",
+    "code_review",
+];
+export const EXECUTOR_CAPABILITIES = [
+    "code_generation",
+    "code_refactoring",
+    "test_generation",
+    "bug_diagnosis",
+    "performance_optimization",
+    "documentation",
+];
+// ── Grading (ISO/IEC 25010) ────────────────────────────────────────
+export const GRADING_DIMENSIONS = [
+    "correctness",
+    "security",
+    "efficiency",
+    "robustness",
+    "maintainability",
+    "usability",
+];
+export const DIMENSION_WEIGHTS = {
+    correctness: 0.30,
+    security: 0.15,
+    efficiency: 0.15,
+    robustness: 0.15,
+    maintainability: 0.15,
+    usability: 0.10,
+};
+// ── ELO ────────────────────────────────────────────────────────────
+export const DEFAULT_ELO = 1500;
+export const DEFAULT_K_FACTOR = 32;
+export const DuoPairRequestSchema = z.object({
+    prompt: z.string().min(1),
+    conversationContext: z.string().optional(),
+    preferredArchitect: z.string().optional(),
+    preferredExecutor: z.string().optional(),
+    judgeModel: z.string().optional(),
+    enableGrading: z.boolean().optional(),
+    requireConfirmation: z.boolean().optional(),
+    architectOnly: z.boolean().optional(),
+    precomputedPlan: z.string().optional(),
+    enableTools: z.boolean().optional(),
+    projectRoot: z.string().optional(),
+    projectContext: z.string().optional(),
+    includedFiles: z.array(z.object({ path: z.string(), reason: z.string() })).optional(),
+});
+//# sourceMappingURL=duo_types.js.map

package/dist/duo/duo_types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duo_types.js","sourceRoot":"","sources":["../../src/duo/duo_types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,gBAAgB;IAChB,qBAAqB;IACrB,YAAY;IACZ,eAAe;IACf,mBAAmB;IACnB,aAAa;CACL,CAAC;AAEX,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,iBAAiB;IACjB,kBAAkB;IAClB,iBAAiB;IACjB,eAAe;IACf,0BAA0B;IAC1B,eAAe;CACP,CAAC;AAsBX,sEAAsE;AAEtE,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,aAAa;IACb,UAAU;IACV,YAAY;IACZ,YAAY;IACZ,iBAAiB;IACjB,WAAW;CACH,CAAC;AAIX,MAAM,CAAC,MAAM,iBAAiB,GAAqC;IACjE,WAAW,EAAE,IAAI;IACjB,QAAQ,EAAE,IAAI;IACd,UAAU,EAAE,IAAI;IAChB,UAAU,EAAE,IAAI;IAChB,eAAe,EAAE,IAAI;IACrB,SAAS,EAAE,IAAI;CAChB,CAAC;AAkBF,sEAAsE;AAEtE,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC;AAChC,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAsEnC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1C,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzC,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACxC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACrC,mBAAmB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC3C,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACrC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACnC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;CACtF,CAAC,CAAC"}

package/dist/duo/session_store.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Session serialization: save/resume/list DuoSession state to disk.
+ * Stored as JSON in `.duocode/sessions/`.
+ */
+import type { DuoPairAssignment } from "./duo_types.js";
+import { DuoSession, type ConversationTurn, type InteractiveMode, type PendingPlan } from "./duo_session.js";
+export interface SerializedSession {
+    id: string;
+    createdAt: number;
+    updatedAt: number;
+    turns: ConversationTurn[];
+    totalCostUsd: number;
+    mode: InteractiveMode;
+    gradingEnabled: boolean;
+    autoConfirm: boolean;
+    assignment: DuoPairAssignment | null;
+    pendingPlan: PendingPlan | null;
+    /** First prompt preview for listing */
+    promptPreview: string;
+}
+export interface CompactedTurn {
+    prompt: string;
+    architectPlan: string;
+    executorOutput: string;
+    grading?: ConversationTurn["grading"];
+    costUsd: number;
+    durationMs: number;
+    timestamp: number;
+}
+/**
+ * Summarize older turns into a condensed block.
+ * Keeps the last `keep` turns intact and compresses the rest.
+ */
+export declare function compactTurns(turns: readonly ConversationTurn[], keep?: number): ConversationTurn[];
+export declare class SessionStore {
+    private readonly dir;
+    private pendingSave;
+    constructor(projectRoot: string);
+    private ensureDir;
+    private sessionPath;
+    /**
+     * Serialize current DuoSession to disk.
+     * Returns the session ID.
+     */
+    save(session: DuoSession, existingId?: string): string;
+    /**
+     * Non-blocking save: schedules a write-behind save.
+     * Does not block the REPL loop.
+     */
+    saveAsync(session: DuoSession, existingId?: string): string;
+    /**
+     * Wait for any pending async save to complete.
+     */
+    flush(): Promise<void>;
+    /**
+     * Load a session from disk and restore into a DuoSession instance.
+     */
+    resume(id: string): {
+        session: DuoSession;
+        data: SerializedSession;
+    };
+    /**
+     * List saved sessions, sorted by most recent first.
+     */
+    list(): SerializedSession[];
+    /**
+     * Delete a saved session.
+     */
+    delete(id: string): boolean;
+    private getCreatedAt;
+}

package/dist/duo/session_store.js

@@ -0,0 +1,177 @@
+/**
+ * Session serialization: save/resume/list DuoSession state to disk.
+ * Stored as JSON in `.duocode/sessions/`.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import crypto from "node:crypto";
+import { DuoSession, } from "./duo_session.js";
+/**
+ * Summarize older turns into a condensed block.
+ * Keeps the last `keep` turns intact and compresses the rest.
+ */
+export function compactTurns(turns, keep = 5) {
+    if (turns.length <= keep)
+        return [...turns];
+    const older = turns.slice(0, turns.length - keep);
+    const recent = turns.slice(turns.length - keep);
+    // Build a condensed summary turn
+    const summaryLines = older.map((t, i) => `Turn ${i + 1}: "${t.prompt.slice(0, 80)}" ($${t.costUsd.toFixed(4)}, ${t.durationMs}ms)`);
+    const summaryTurn = {
+        prompt: "[compacted summary]",
+        architectPlan: `Compacted ${older.length} earlier turns:\n${summaryLines.join("\n")}`,
+        executorOutput: "",
+        costUsd: older.reduce((s, t) => s + t.costUsd, 0),
+        durationMs: older.reduce((s, t) => s + t.durationMs, 0),
+        timestamp: older[0].timestamp,
+    };
+    return [summaryTurn, ...recent];
+}
+// ── Session Store ───────────────────────────────────────────────
+export class SessionStore {
+    dir;
+    pendingSave = null;
+    constructor(projectRoot) {
+        this.dir = path.join(projectRoot, ".duocode", "sessions");
+    }
+    ensureDir() {
+        if (!fs.existsSync(this.dir)) {
+            fs.mkdirSync(this.dir, { recursive: true });
+        }
+    }
+    sessionPath(id) {
+        return path.join(this.dir, `${id}.json`);
+    }
+    /**
+     * Serialize current DuoSession to disk.
+     * Returns the session ID.
+     */
+    save(session, existingId) {
+        this.ensureDir();
+        const id = existingId ?? crypto.randomUUID();
+        const turns = session.getTurns();
+        const firstPrompt = turns.length > 0 ? turns[0].prompt : "(empty)";
+        const data = {
+            id,
+            createdAt: existingId ? this.getCreatedAt(id) : Date.now(),
+            updatedAt: Date.now(),
+            turns: [...turns],
+            totalCostUsd: session.getTotalCost(),
+            mode: session.mode,
+            gradingEnabled: session.gradingEnabled,
+            autoConfirm: session.autoConfirm,
+            assignment: session.assignment,
+            pendingPlan: session.pendingPlan,
+            promptPreview: firstPrompt.length > 60
+                ? firstPrompt.slice(0, 57) + "..."
+                : firstPrompt,
+        };
+        fs.writeFileSync(this.sessionPath(id), JSON.stringify(data, null, 2));
+        return id;
+    }
+    /**
+     * Non-blocking save: schedules a write-behind save.
+     * Does not block the REPL loop.
+     */
+    saveAsync(session, existingId) {
+        const id = existingId ?? crypto.randomUUID();
+        this.pendingSave = new Promise((resolve) => {
+            // Use setImmediate to defer to next tick
+            setImmediate(() => {
+                try {
+                    this.save(session, id);
+                }
+                catch {
+                    // Write-behind — don't crash on save failure
+                }
+                resolve();
+            });
+        });
+        return id;
+    }
+    /**
+     * Wait for any pending async save to complete.
+     */
+    async flush() {
+        if (this.pendingSave) {
+            await this.pendingSave;
+            this.pendingSave = null;
+        }
+    }
+    /**
+     * Load a session from disk and restore into a DuoSession instance.
+     */
+    resume(id) {
+        const filePath = this.sessionPath(id);
+        if (!fs.existsSync(filePath)) {
+            throw new Error(`Session not found: ${id}`);
+        }
+        const raw = fs.readFileSync(filePath, "utf-8");
+        const data = JSON.parse(raw);
+        const session = new DuoSession();
+        // Restore turns
+        for (const turn of data.turns) {
+            session.addTurn(turn);
+        }
+        // Restore mode and toggles
+        session.setMode(data.mode);
+        if (data.gradingEnabled !== session.gradingEnabled) {
+            session.toggleGrading();
+        }
+        if (data.autoConfirm !== session.autoConfirm) {
+            session.toggleAutoConfirm();
+        }
+        // Restore assignment
+        session.assignment = data.assignment;
+        // Restore pending plan
+        if (data.pendingPlan) {
+            session.storePlan(data.pendingPlan);
+        }
+        return { session, data };
+    }
+    /**
+     * List saved sessions, sorted by most recent first.
+     */
+    list() {
+        if (!fs.existsSync(this.dir))
+            return [];
+        const files = fs.readdirSync(this.dir).filter((f) => f.endsWith(".json"));
+        const sessions = [];
+        for (const file of files) {
+            try {
+                const raw = fs.readFileSync(path.join(this.dir, file), "utf-8");
+                sessions.push(JSON.parse(raw));
+            }
+            catch {
+                // Skip corrupted files
+            }
+        }
+        return sessions.sort((a, b) => b.updatedAt - a.updatedAt);
+    }
+    /**
+     * Delete a saved session.
+     */
+    delete(id) {
+        const filePath = this.sessionPath(id);
+        if (fs.existsSync(filePath)) {
+            fs.unlinkSync(filePath);
+            return true;
+        }
+        return false;
+    }
+    getCreatedAt(id) {
+        const filePath = this.sessionPath(id);
+        if (fs.existsSync(filePath)) {
+            try {
+                const raw = fs.readFileSync(filePath, "utf-8");
+                const data = JSON.parse(raw);
+                return data.createdAt;
+            }
+            catch {
+                // Fallback
+            }
+        }
+        return Date.now();
+    }
+}
+//# sourceMappingURL=session_store.js.map

package/dist/duo/session_store.js.map

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

package/dist/git/worktree.d.ts

@@ -0,0 +1,21 @@
+export interface WorktreeEntry {
+    path: string;
+    head: string;
+    branch: string | null;
+    bare: boolean;
+    detached: boolean;
+    locked: boolean;
+    prunable: boolean;
+}
+export declare function ensureGitRepository(repoPath: string): void;
+export declare function sanitizeBranchName(raw: string): string;
+export declare function createWorktree(params: {
+    repoPath: string;
+    worktreePath: string;
+    branchName: string;
+    baseRef?: string;
+}): void;
+export declare function removeWorktree(repoPath: string, worktreePath: string, force?: boolean): void;
+export declare function pruneWorktrees(repoPath: string): void;
+export declare function listWorktrees(repoPath: string): WorktreeEntry[];
+export declare function findWorktreeByBranch(repoPath: string, branchName: string): WorktreeEntry | null;