@otto-code/server 0.5.0

package/dist/server/server/checkout/status-projection.js

@@ -0,0 +1,117 @@
+export function buildCheckoutStatusPayloadFromSnapshot({ cwd, requestId, snapshot, }) {
+    if (!snapshot.git.isGit) {
+        return {
+            cwd,
+            isGit: false,
+            repoRoot: null,
+            currentBranch: null,
+            isDirty: null,
+            baseRef: null,
+            aheadBehind: null,
+            aheadOfOrigin: null,
+            behindOfOrigin: null,
+            hasRemote: false,
+            remoteUrl: null,
+            isOttoOwnedWorktree: false,
+            error: null,
+            requestId,
+        };
+    }
+    if (snapshot.git.repoRoot === null || snapshot.git.isDirty === null) {
+        throw new Error("Workspace git snapshot is missing required checkout status fields");
+    }
+    if (snapshot.git.isOttoOwnedWorktree) {
+        if (snapshot.git.mainRepoRoot === null || snapshot.git.baseRef === null) {
+            throw new Error("Workspace git snapshot is missing required worktree status fields");
+        }
+        return {
+            cwd,
+            isGit: true,
+            repoRoot: snapshot.git.repoRoot,
+            mainRepoRoot: snapshot.git.mainRepoRoot,
+            currentBranch: snapshot.git.currentBranch ?? null,
+            isDirty: snapshot.git.isDirty,
+            baseRef: snapshot.git.baseRef,
+            aheadBehind: snapshot.git.aheadBehind ?? null,
+            aheadOfOrigin: snapshot.git.aheadOfOrigin ?? null,
+            behindOfOrigin: snapshot.git.behindOfOrigin ?? null,
+            hasRemote: snapshot.git.hasRemote,
+            remoteUrl: snapshot.git.remoteUrl,
+            isOttoOwnedWorktree: true,
+            error: null,
+            requestId,
+        };
+    }
+    return {
+        cwd,
+        isGit: true,
+        repoRoot: snapshot.git.repoRoot,
+        mainRepoRoot: snapshot.git.mainRepoRoot,
+        currentBranch: snapshot.git.currentBranch ?? null,
+        isDirty: snapshot.git.isDirty,
+        baseRef: snapshot.git.baseRef ?? null,
+        aheadBehind: snapshot.git.aheadBehind ?? null,
+        aheadOfOrigin: snapshot.git.aheadOfOrigin ?? null,
+        behindOfOrigin: snapshot.git.behindOfOrigin ?? null,
+        hasRemote: snapshot.git.hasRemote,
+        remoteUrl: snapshot.git.remoteUrl,
+        isOttoOwnedWorktree: false,
+        error: null,
+        requestId,
+    };
+}
+export function buildCheckoutPrStatusPayloadFromSnapshot({ cwd, requestId, snapshot, }) {
+    const provider = snapshot.github.provider ?? "github";
+    return {
+        cwd,
+        status: normalizeCheckoutPrStatusPayload(snapshot.github.pullRequest),
+        // Legacy GitHub-only flag: old clients read this, so it must stay false
+        // for non-GitHub providers (they would otherwise render GitHub UI against
+        // a Bitbucket workspace).
+        githubFeaturesEnabled: provider === "github" && snapshot.github.featuresEnabled,
+        hosting: {
+            provider,
+            featuresEnabled: snapshot.github.featuresEnabled,
+            ...(snapshot.github.capabilities ? { capabilities: snapshot.github.capabilities } : {}),
+        },
+        error: snapshot.github.error
+            ? {
+                code: "UNKNOWN",
+                message: snapshot.github.error.message,
+            }
+            : null,
+        requestId,
+    };
+}
+export function normalizeCheckoutPrStatusPayload(status) {
+    if (!status) {
+        return null;
+    }
+    const payload = {
+        number: status.number,
+        url: status.url,
+        title: status.title,
+        state: status.state,
+        repoOwner: status.repoOwner,
+        repoName: status.repoName,
+        baseRefName: status.baseRefName,
+        headRefName: status.headRefName,
+        isMerged: status.isMerged,
+        isDraft: status.isDraft ?? false,
+        mergeable: status.mergeable ?? "UNKNOWN",
+        checks: status.checks ?? [],
+        checksStatus: status.checksStatus,
+        reviewDecision: status.reviewDecision,
+    };
+    if (status.github) {
+        payload.github = status.github;
+    }
+    if (status.bitbucket) {
+        payload.hosting = {
+            provider: "bitbucket-cloud",
+            bitbucket: status.bitbucket,
+        };
+    }
+    return payload;
+}
+//# sourceMappingURL=status-projection.js.map

package/dist/server/server/checkout-diff-manager.d.ts

@@ -0,0 +1,41 @@
+import type pino from "pino";
+import type { SubscribeCheckoutDiffRequest, SessionOutboundMessage } from "./messages.js";
+import type { WorkspaceGitService } from "./workspace-git-service.js";
+export type CheckoutDiffCompareInput = SubscribeCheckoutDiffRequest["compare"];
+export type CheckoutDiffSnapshotPayload = Omit<Extract<SessionOutboundMessage, {
+    type: "checkout_diff_update";
+}>["payload"], "subscriptionId">;
+export interface CheckoutDiffMetrics {
+    checkoutDiffTargetCount: number;
+    checkoutDiffSubscriptionCount: number;
+    checkoutDiffWatcherCount: number;
+    checkoutDiffFallbackRefreshTargetCount: number;
+}
+export declare class CheckoutDiffManager {
+    private readonly workspaceGitService;
+    private readonly targets;
+    constructor(options: {
+        logger: pino.Logger;
+        ottoHome: string;
+        workspaceGitService: WorkspaceGitService;
+    });
+    subscribe(params: {
+        cwd: string;
+        compare: CheckoutDiffCompareInput;
+    }, listener: (snapshot: CheckoutDiffSnapshotPayload) => void): Promise<{
+        initial: CheckoutDiffSnapshotPayload;
+        unsubscribe: () => void;
+    }>;
+    scheduleRefreshForCwd(cwd: string): void;
+    getMetrics(): CheckoutDiffMetrics;
+    dispose(): void;
+    private normalizeCompare;
+    private buildTargetKey;
+    private closeTarget;
+    private removeListener;
+    private scheduleTargetRefresh;
+    private computeCheckoutDiffSnapshot;
+    private refreshTarget;
+    private ensureTarget;
+}
+//# sourceMappingURL=checkout-diff-manager.d.ts.map

package/dist/server/server/checkout-diff-manager.js

@@ -0,0 +1,189 @@
+import { expandTilde } from "../utils/path.js";
+import { toCheckoutError } from "./checkout-git-utils.js";
+const CHECKOUT_DIFF_WATCH_DEBOUNCE_MS = 150;
+export class CheckoutDiffManager {
+    constructor(options) {
+        this.targets = new Map();
+        this.workspaceGitService = options.workspaceGitService;
+    }
+    async subscribe(params, listener) {
+        const cwd = params.cwd;
+        const compare = this.normalizeCompare(params.compare);
+        const target = await this.ensureTarget(cwd, compare);
+        target.listeners.add(listener);
+        const initial = target.latestPayload ??
+            (await this.computeCheckoutDiffSnapshot(target.cwd, target.compare, {
+                diffCwd: target.diffCwd,
+            }));
+        target.latestPayload = initial;
+        target.latestFingerprint = JSON.stringify(initial);
+        return {
+            initial,
+            unsubscribe: () => {
+                this.removeListener(target.key, listener);
+            },
+        };
+    }
+    scheduleRefreshForCwd(cwd) {
+        const resolvedCwd = expandTilde(cwd);
+        for (const target of this.targets.values()) {
+            if (target.cwd !== resolvedCwd && target.diffCwd !== resolvedCwd) {
+                continue;
+            }
+            this.scheduleTargetRefresh(target);
+        }
+    }
+    getMetrics() {
+        let checkoutDiffSubscriptionCount = 0;
+        for (const target of this.targets.values()) {
+            checkoutDiffSubscriptionCount += target.listeners.size;
+        }
+        return {
+            checkoutDiffTargetCount: this.targets.size,
+            checkoutDiffSubscriptionCount,
+            checkoutDiffWatcherCount: 0,
+            checkoutDiffFallbackRefreshTargetCount: 0,
+        };
+    }
+    dispose() {
+        for (const target of this.targets.values()) {
+            this.closeTarget(target);
+        }
+        this.targets.clear();
+    }
+    normalizeCompare(compare) {
+        const ignoreWhitespace = compare.ignoreWhitespace === true;
+        if (compare.mode === "uncommitted") {
+            return { mode: "uncommitted", ignoreWhitespace };
+        }
+        const trimmedBaseRef = compare.baseRef?.trim();
+        return trimmedBaseRef
+            ? { mode: "base", baseRef: trimmedBaseRef, ignoreWhitespace }
+            : { mode: "base", ignoreWhitespace };
+    }
+    buildTargetKey(cwd, compare) {
+        return JSON.stringify([
+            cwd,
+            compare.mode,
+            compare.mode === "base" ? (compare.baseRef ?? "") : "",
+            compare.ignoreWhitespace === true,
+        ]);
+    }
+    closeTarget(target) {
+        if (target.debounceTimer) {
+            clearTimeout(target.debounceTimer);
+            target.debounceTimer = null;
+        }
+        target.workingTreeWatchUnsubscribe?.();
+        target.workingTreeWatchUnsubscribe = null;
+        target.listeners.clear();
+    }
+    removeListener(targetKey, listener) {
+        const target = this.targets.get(targetKey);
+        if (!target) {
+            return;
+        }
+        target.listeners.delete(listener);
+        if (target.listeners.size > 0) {
+            return;
+        }
+        this.closeTarget(target);
+        this.targets.delete(targetKey);
+    }
+    scheduleTargetRefresh(target) {
+        if (target.debounceTimer) {
+            clearTimeout(target.debounceTimer);
+        }
+        target.debounceTimer = setTimeout(() => {
+            target.debounceTimer = null;
+            void this.refreshTarget(target);
+        }, CHECKOUT_DIFF_WATCH_DEBOUNCE_MS);
+    }
+    async computeCheckoutDiffSnapshot(cwd, compare, options) {
+        const diffCwd = options?.diffCwd ?? cwd;
+        try {
+            const diffResult = await this.workspaceGitService.getCheckoutDiff(diffCwd, {
+                mode: compare.mode,
+                baseRef: compare.baseRef,
+                ignoreWhitespace: compare.ignoreWhitespace,
+                includeStructured: true,
+            }, options?.force
+                ? { force: true, reason: options.reason ?? "checkout-diff-refresh" }
+                : undefined);
+            const files = [...(diffResult.structured ?? [])];
+            files.sort((a, b) => {
+                if (a.path === b.path)
+                    return 0;
+                return a.path < b.path ? -1 : 1;
+            });
+            return {
+                cwd,
+                files,
+                error: null,
+            };
+        }
+        catch (error) {
+            return {
+                cwd,
+                files: [],
+                error: toCheckoutError(error),
+            };
+        }
+    }
+    async refreshTarget(target) {
+        if (target.refreshPromise) {
+            target.refreshQueued = true;
+            return;
+        }
+        target.refreshPromise = (async () => {
+            do {
+                target.refreshQueued = false;
+                const snapshot = await this.computeCheckoutDiffSnapshot(target.cwd, target.compare, {
+                    diffCwd: target.diffCwd,
+                    force: true,
+                    reason: "working-tree-watch",
+                });
+                target.latestPayload = snapshot;
+                const fingerprint = JSON.stringify(snapshot);
+                if (fingerprint !== target.latestFingerprint) {
+                    target.latestFingerprint = fingerprint;
+                    for (const listener of target.listeners) {
+                        listener(snapshot);
+                    }
+                }
+            } while (target.refreshQueued);
+        })();
+        try {
+            await target.refreshPromise;
+        }
+        finally {
+            target.refreshPromise = null;
+        }
+    }
+    async ensureTarget(cwd, compare) {
+        const targetKey = this.buildTargetKey(cwd, compare);
+        const existing = this.targets.get(targetKey);
+        if (existing) {
+            return existing;
+        }
+        const target = {
+            key: targetKey,
+            cwd,
+            diffCwd: cwd,
+            compare,
+            listeners: new Set(),
+            workingTreeWatchUnsubscribe: null,
+            debounceTimer: null,
+            refreshPromise: null,
+            refreshQueued: false,
+            latestPayload: null,
+            latestFingerprint: null,
+        };
+        const { repoRoot, unsubscribe } = await this.workspaceGitService.requestWorkingTreeWatch(cwd, () => this.scheduleTargetRefresh(target));
+        target.diffCwd = repoRoot ?? cwd;
+        target.workingTreeWatchUnsubscribe = unsubscribe;
+        this.targets.set(targetKey, target);
+        return target;
+    }
+}
+//# sourceMappingURL=checkout-diff-manager.js.map

package/dist/server/server/checkout-git-utils.d.ts

@@ -0,0 +1,11 @@
+export declare const READ_ONLY_GIT_ENV: {
+    readonly GIT_OPTIONAL_LOCKS: "0";
+};
+export type CheckoutErrorCode = "NOT_GIT_REPO" | "NOT_ALLOWED" | "MERGE_CONFLICT" | "UNKNOWN";
+export interface CheckoutErrorPayload {
+    code: CheckoutErrorCode;
+    message: string;
+}
+export declare function resolveCheckoutGitDir(cwd: string): Promise<string | null>;
+export declare function toCheckoutError(error: unknown): CheckoutErrorPayload;
+//# sourceMappingURL=checkout-git-utils.d.ts.map

package/dist/server/server/checkout-git-utils.js

@@ -0,0 +1,34 @@
+import { MergeConflictError, MergeFromBaseConflictError, NotGitRepoError, } from "../utils/checkout-git.js";
+import { runGitCommand } from "../utils/run-git-command.js";
+export const READ_ONLY_GIT_ENV = {
+    GIT_OPTIONAL_LOCKS: "0",
+};
+export async function resolveCheckoutGitDir(cwd) {
+    try {
+        const { stdout } = await runGitCommand(["rev-parse", "--absolute-git-dir"], {
+            cwd,
+            envOverlay: READ_ONLY_GIT_ENV,
+        });
+        const gitDir = stdout.trim();
+        return gitDir.length > 0 ? gitDir : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function toCheckoutError(error) {
+    if (error instanceof NotGitRepoError) {
+        return { code: "NOT_GIT_REPO", message: error.message };
+    }
+    if (error instanceof MergeConflictError) {
+        return { code: "MERGE_CONFLICT", message: error.message };
+    }
+    if (error instanceof MergeFromBaseConflictError) {
+        return { code: "MERGE_CONFLICT", message: error.message };
+    }
+    if (error instanceof Error) {
+        return { code: "UNKNOWN", message: error.message };
+    }
+    return { code: "UNKNOWN", message: String(error) };
+}
+//# sourceMappingURL=checkout-git-utils.js.map

package/dist/server/server/client-message-id.d.ts

@@ -0,0 +1,3 @@
+export declare function normalizeClientMessageId(clientMessageId: string | undefined): string | undefined;
+export declare function resolveClientMessageId(clientMessageId: string | undefined, generateId?: () => string): string;
+//# sourceMappingURL=client-message-id.d.ts.map

package/dist/server/server/client-message-id.js

@@ -0,0 +1,12 @@
+import { v4 as uuidv4 } from "uuid";
+export function normalizeClientMessageId(clientMessageId) {
+    if (typeof clientMessageId !== "string") {
+        return undefined;
+    }
+    const trimmed = clientMessageId.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+export function resolveClientMessageId(clientMessageId, generateId = uuidv4) {
+    return normalizeClientMessageId(clientMessageId) ?? generateId();
+}
+//# sourceMappingURL=client-message-id.js.map

package/dist/server/server/config.d.ts

@@ -0,0 +1,22 @@
+import type { OttoDaemonConfig } from "./bootstrap.js";
+import { type HostnamesConfig } from "./hostnames.js";
+interface ResolveBundledWebUiDistDirInput {
+    moduleUrl?: string | URL;
+    resourcesPath?: string;
+}
+export declare function resolveBundledWebUiDistDir(input?: ResolveBundledWebUiDistDirInput): string;
+export type CliConfigOverrides = Partial<{
+    listen: string;
+    relayEnabled: boolean;
+    relayUseTls: boolean;
+    mcpEnabled: boolean;
+    mcpInjectIntoAgents: boolean;
+    webUiEnabled: boolean;
+    hostnames: HostnamesConfig;
+}>;
+export declare function loadConfig(ottoHome: string, options?: {
+    env?: NodeJS.ProcessEnv;
+    cli?: CliConfigOverrides;
+}): OttoDaemonConfig;
+export {};
+//# sourceMappingURL=config.d.ts.map