@otto-code/server 0.5.0

package/dist/server/server/agent/prompt-attachments.js

@@ -0,0 +1,117 @@
+import { normalizeGitHostingProviderId } from "@otto-code/protocol/messages";
+const REVIEW_LINE_MARKERS = { add: "+", remove: "-", context: " " };
+const HOSTING_PROVIDER_LABELS = {
+    github: "GitHub",
+    "bitbucket-cloud": "Bitbucket",
+};
+// The wire provider id is an open string (forward-compat), so degrade to a
+// neutral label for a provider this build doesn't recognize.
+function hostingProviderLabel(provider) {
+    const known = normalizeGitHostingProviderId(provider);
+    return known ? HOSTING_PROVIDER_LABELS[known] : "Git";
+}
+export function renderPromptAttachmentAsText(attachment) {
+    switch (attachment.type) {
+        case "github_pr": {
+            const lines = [`GitHub PR #${attachment.number}: ${attachment.title}`, attachment.url];
+            if (attachment.baseRefName) {
+                lines.push(`Base: ${attachment.baseRefName}`);
+            }
+            if (attachment.headRefName) {
+                lines.push(`Head: ${attachment.headRefName}`);
+            }
+            if (attachment.body) {
+                lines.push("", attachment.body);
+            }
+            return lines.join("\n");
+        }
+        case "github_issue": {
+            const lines = [`GitHub Issue #${attachment.number}: ${attachment.title}`, attachment.url];
+            if (attachment.body) {
+                lines.push("", attachment.body);
+            }
+            return lines.join("\n");
+        }
+        case "hosting_pr": {
+            const label = hostingProviderLabel(attachment.provider);
+            const lines = [`${label} PR #${attachment.number}: ${attachment.title}`, attachment.url];
+            if (attachment.baseRefName) {
+                lines.push(`Base: ${attachment.baseRefName}`);
+            }
+            if (attachment.headRefName) {
+                lines.push(`Head: ${attachment.headRefName}`);
+            }
+            if (attachment.body) {
+                lines.push("", attachment.body);
+            }
+            return lines.join("\n");
+        }
+        case "hosting_issue": {
+            const label = hostingProviderLabel(attachment.provider);
+            const lines = [`${label} Issue #${attachment.number}: ${attachment.title}`, attachment.url];
+            if (attachment.body) {
+                lines.push("", attachment.body);
+            }
+            return lines.join("\n");
+        }
+        case "text": {
+            return attachment.text;
+        }
+        case "review": {
+            const lines = [`Otto review attachment (${attachment.mode})`, `CWD: ${attachment.cwd}`];
+            if (attachment.baseRef) {
+                lines.push(`Base: ${attachment.baseRef}`);
+            }
+            attachment.comments.forEach((comment, index) => {
+                lines.push("", `Comment ${index + 1}: ${comment.filePath}:${comment.side}:${comment.lineNumber}`, comment.body, comment.context.hunkHeader);
+                const target = comment.context.targetLine;
+                for (const line of comment.context.lines) {
+                    const isTarget = line.oldLineNumber === target.oldLineNumber &&
+                        line.newLineNumber === target.newLineNumber &&
+                        line.type === target.type &&
+                        line.content === target.content;
+                    const prefix = isTarget ? "> " : "  ";
+                    const oldLn = padLineNumber(line.oldLineNumber);
+                    const newLn = padLineNumber(line.newLineNumber);
+                    lines.push(`${prefix}${oldLn} ${newLn} ${REVIEW_LINE_MARKERS[line.type]}${line.content}`);
+                }
+            });
+            return lines.join("\n");
+        }
+        case "uploaded_file": {
+            return [
+                `Uploaded file: ${attachment.fileName}`,
+                `Path: ${attachment.path}`,
+                `MIME: ${attachment.mimeType}`,
+                `Size: ${attachment.size} bytes`,
+            ].join("\n");
+        }
+        default:
+            throw new Error("unreachable");
+    }
+}
+function padLineNumber(lineNumber) {
+    return (lineNumber?.toString() ?? "-").padStart(2);
+}
+export function buildAgentBranchNameSeed(firstAgentContext) {
+    if (!firstAgentContext) {
+        return undefined;
+    }
+    const parts = [];
+    const prompt = firstAgentContext.prompt?.trim();
+    if (prompt) {
+        parts.push(["<user-prompt>", prompt, "</user-prompt>"].join("\n"));
+    }
+    const renderedAttachments = [];
+    for (const attachment of firstAgentContext.attachments ?? []) {
+        const rendered = renderPromptAttachmentAsText(attachment).trim();
+        if (rendered) {
+            renderedAttachments.push(rendered);
+        }
+    }
+    if (renderedAttachments.length > 0) {
+        parts.push(["<attachments>", renderedAttachments.join("\n\n"), "</attachments>"].join("\n"));
+    }
+    return parts.length > 0 ? parts.join("\n\n") : undefined;
+}
+//# sourceMappingURL=prompt-attachments.js.map

package/dist/server/server/agent/provider-history-timestamps.d.ts

@@ -0,0 +1,2 @@
+export declare function normalizeProviderReplayTimestamp(value: unknown): string | null;
+//# sourceMappingURL=provider-history-timestamps.d.ts.map

package/dist/server/server/agent/provider-history-timestamps.js

@@ -0,0 +1,16 @@
+export function normalizeProviderReplayTimestamp(value) {
+    if (typeof value === "string") {
+        const timestamp = value.trim();
+        if (!timestamp || Number.isNaN(Date.parse(timestamp))) {
+            return null;
+        }
+        return timestamp;
+    }
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        return null;
+    }
+    const timestampMs = value > 1000000000000 ? value : value * 1000;
+    const date = new Date(timestampMs);
+    return Number.isNaN(date.getTime()) ? null : date.toISOString();
+}
+//# sourceMappingURL=provider-history-timestamps.js.map

package/dist/server/server/agent/provider-launch-config.d.ts

@@ -0,0 +1,43 @@
+import { type ProcessEnvRecord } from "../otto-env.js";
+export { AgentProviderRuntimeSettingsMapSchema, ProviderCommandSchema, ProviderOverrideSchema, ProviderOverridesSchema, ProviderProfileModelSchema, ProviderRuntimeSettingsSchema, type AgentProviderRuntimeSettingsMap, type ProviderCommand, type ProviderOverride, type ProviderOverrides, type ProviderProfileModel, type ProviderRuntimeSettings, } from "@otto-code/protocol/provider-config";
+import { type ProviderCommand, type ProviderOverrides, type ProviderRuntimeSettings } from "@otto-code/protocol/provider-config";
+export interface ProviderCommandPrefix {
+    command: string;
+    args: string[];
+}
+export type ProviderLaunchSource = "default" | "append" | "override";
+export interface ResolvedProviderLaunch {
+    command: string;
+    args: string[];
+    source: ProviderLaunchSource;
+}
+export interface ProviderLaunchAvailability {
+    available: boolean;
+    resolvedPath: string | null;
+}
+export interface ProviderLaunchDefault {
+    command: string;
+    resolvePath?: () => Promise<string | null>;
+}
+export interface ResolveProviderLaunchOptions {
+    commandConfig?: ProviderCommand;
+    defaultBinary?: string | ProviderLaunchDefault;
+}
+export declare function resolveProviderLaunch({ commandConfig, defaultBinary, }: ResolveProviderLaunchOptions): Promise<ResolvedProviderLaunch>;
+export declare function checkProviderLaunchAvailable(launch: ResolvedProviderLaunch, defaultBinary?: ProviderLaunchDefault): Promise<ProviderLaunchAvailability>;
+export declare function resolveProviderCommandPrefix(commandConfig: ProviderCommand | undefined, resolveDefaultCommand: () => string | Promise<string>): Promise<ProviderCommandPrefix>;
+export declare function resolveShellEnv(): Record<string, string>;
+export declare function migrateProviderSettings(raw: Record<string, unknown>, builtinProviderIds: string[]): ProviderOverrides;
+export interface ProviderEnvOptions {
+    baseEnv?: ProcessEnvRecord;
+    runtimeSettings?: ProviderRuntimeSettings;
+    overlays?: Array<ProcessEnvRecord | undefined>;
+}
+export interface ProviderEnvSpec {
+    baseEnv?: ProcessEnvRecord;
+    envOverlay: ProcessEnvRecord;
+}
+export declare function createProviderEnvSpec(options?: ProviderEnvOptions): ProviderEnvSpec;
+export declare function createProviderEnv(options?: ProviderEnvOptions): NodeJS.ProcessEnv;
+export declare function isProviderCommandAvailable(commandConfig: ProviderCommand | undefined, resolveDefaultCommand: () => string | Promise<string>): Promise<boolean>;
+//# sourceMappingURL=provider-launch-config.d.ts.map

package/dist/server/server/agent/provider-launch-config.js

@@ -0,0 +1,167 @@
+import { isAbsolute } from "node:path";
+import { executableExists, findExecutable, } from "../../executable-resolution/executable-resolution.js";
+import { createExternalProcessEnv } from "../otto-env.js";
+export { AgentProviderRuntimeSettingsMapSchema, ProviderCommandSchema, ProviderOverrideSchema, ProviderOverridesSchema, ProviderProfileModelSchema, ProviderRuntimeSettingsSchema, } from "@otto-code/protocol/provider-config";
+import { ProviderOverrideSchema, ProviderOverridesSchema, ProviderRuntimeSettingsSchema, } from "@otto-code/protocol/provider-config";
+function normalizeLaunchDefault(defaultBinary) {
+    if (typeof defaultBinary === "string") {
+        return { command: defaultBinary };
+    }
+    return defaultBinary;
+}
+async function resolveLaunchPath(command) {
+    const found = await findExecutable(command);
+    if (found) {
+        return found;
+    }
+    if (isAbsolute(command)) {
+        return executableExists(command);
+    }
+    return null;
+}
+async function resolveDefaultLaunchPath(defaultBinary) {
+    return defaultBinary.resolvePath
+        ? await defaultBinary.resolvePath()
+        : await resolveLaunchPath(defaultBinary.command);
+}
+export async function resolveProviderLaunch({ commandConfig, defaultBinary, }) {
+    if (commandConfig?.mode === "replace") {
+        const command = commandConfig.argv[0];
+        return {
+            command,
+            args: commandConfig.argv.slice(1),
+            source: "override",
+        };
+    }
+    if (defaultBinary === undefined) {
+        throw new Error("defaultBinary is required when provider command is not replaced");
+    }
+    const normalizedDefault = normalizeLaunchDefault(defaultBinary);
+    const args = commandConfig?.mode === "append" ? [...(commandConfig.args ?? [])] : [];
+    return {
+        command: normalizedDefault.command,
+        args,
+        source: commandConfig?.mode === "append" ? "append" : "default",
+    };
+}
+export async function checkProviderLaunchAvailable(launch, defaultBinary) {
+    const resolvedPath = defaultBinary && launch.source !== "override"
+        ? await resolveDefaultLaunchPath(defaultBinary)
+        : await resolveLaunchPath(launch.command);
+    return {
+        available: resolvedPath !== null,
+        resolvedPath,
+    };
+}
+export async function resolveProviderCommandPrefix(commandConfig, resolveDefaultCommand) {
+    if (commandConfig?.mode === "replace") {
+        const launch = await resolveProviderLaunch({
+            commandConfig,
+        });
+        return {
+            command: launch.command,
+            args: launch.args,
+        };
+    }
+    const defaultCommand = await resolveDefaultCommand();
+    const launch = await resolveProviderLaunch({
+        commandConfig,
+        defaultBinary: {
+            command: defaultCommand,
+            resolvePath: async () => defaultCommand,
+        },
+    });
+    return {
+        command: launch.command,
+        args: launch.args,
+    };
+}
+let cachedShellEnv = null;
+export function resolveShellEnv() {
+    if (cachedShellEnv) {
+        return cachedShellEnv;
+    }
+    cachedShellEnv = { ...process.env };
+    return cachedShellEnv;
+}
+export function migrateProviderSettings(raw, builtinProviderIds) {
+    const migrated = {};
+    const builtinProviderIdSet = new Set(builtinProviderIds);
+    for (const [providerId, value] of Object.entries(raw)) {
+        const parsedNew = ProviderOverrideSchema.safeParse(value);
+        if (parsedNew.success) {
+            migrated[providerId] = parsedNew.data;
+            continue;
+        }
+        const parsedOld = ProviderRuntimeSettingsSchema.safeParse(value);
+        if (!parsedOld.success) {
+            continue;
+        }
+        const nextEntry = {};
+        const command = parsedOld.data.command;
+        if (command?.mode === "append") {
+            continue;
+        }
+        if (command?.mode === "replace") {
+            nextEntry.command = command.argv;
+        }
+        if (parsedOld.data.env) {
+            nextEntry.env = parsedOld.data.env;
+        }
+        if (!builtinProviderIdSet.has(providerId) && nextEntry.extends === undefined) {
+            delete nextEntry.extends;
+        }
+        migrated[providerId] = nextEntry;
+    }
+    return ProviderOverridesSchema.parse(migrated);
+}
+// Env vars that indicate a running Claude Code session. If the daemon itself is
+// launched from inside Claude Code (e.g. by a Otto agent), these leak into
+// child processes and cause "cannot be launched inside another session" errors.
+const PARENT_SESSION_ENV_VARS = [
+    "CLAUDECODE",
+    "CLAUDE_CODE_ENTRYPOINT",
+    "CLAUDE_CODE_SSE_PORT",
+    "CLAUDE_AGENT_SDK_VERSION",
+];
+function collectProviderEnvOverlays(runtimeSettings, overlays) {
+    return [runtimeSettings?.env, ...overlays].filter((overlay) => !!overlay);
+}
+export function createProviderEnvSpec(options = {}) {
+    const overlays = collectProviderEnvOverlays(options.runtimeSettings, options.overlays ?? []);
+    const envOverlay = Object.assign({}, ...overlays);
+    for (const key of PARENT_SESSION_ENV_VARS) {
+        envOverlay[key] = undefined;
+    }
+    return {
+        ...(options.baseEnv ? { baseEnv: options.baseEnv } : {}),
+        envOverlay,
+    };
+}
+export function createProviderEnv(options = {}) {
+    const spec = createProviderEnvSpec(options);
+    return createExternalProcessEnv(spec.baseEnv ?? process.env, spec.envOverlay);
+}
+export async function isProviderCommandAvailable(commandConfig, resolveDefaultCommand) {
+    try {
+        if (commandConfig?.mode === "replace") {
+            const launch = await resolveProviderLaunch({
+                commandConfig,
+            });
+            const availability = await checkProviderLaunchAvailable(launch);
+            return availability.available;
+        }
+        const defaultCommand = await resolveDefaultCommand();
+        const defaultBinary = {
+            command: defaultCommand,
+            resolvePath: async () => defaultCommand,
+        };
+        const launch = await resolveProviderLaunch({ commandConfig, defaultBinary });
+        const availability = await checkProviderLaunchAvailable(launch, defaultBinary);
+        return availability.available;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=provider-launch-config.js.map

package/dist/server/server/agent/provider-notices.d.ts

@@ -0,0 +1,3 @@
+import type { AgentProviderNotice } from "./agent-sdk-types.js";
+export declare const SETTING_APPLIES_NEXT_TURN_NOTICE: AgentProviderNotice;
+//# sourceMappingURL=provider-notices.d.ts.map

package/dist/server/server/agent/provider-notices.js

@@ -0,0 +1,5 @@
+export const SETTING_APPLIES_NEXT_TURN_NOTICE = {
+    type: "info",
+    message: "This change applies next turn.",
+};
+//# sourceMappingURL=provider-notices.js.map

package/dist/server/server/agent/provider-registry.d.ts

@@ -0,0 +1,41 @@
+import type { Logger } from "pino";
+import type { AgentClient, AgentCreateConfigUnattendedInput, AgentProvider, AgentSession, FetchCatalogOptions, ProviderCatalog, ResolveAgentCreateConfigInput, ResolveAgentCreateConfigResult } from "./agent-sdk-types.js";
+import type { WorkspaceGitService } from "../workspace-git-service.js";
+import type { ManagedProcessRegistry } from "../managed-processes/managed-processes.js";
+import type { AgentProviderRuntimeSettingsMap, ProviderOverride } from "./provider-launch-config.js";
+import { AGENT_PROVIDER_DEFINITIONS, getAgentProviderDefinition, type AgentProviderDefinition } from "@otto-code/protocol/provider-manifest";
+export type { AgentProviderDefinition };
+export { AGENT_PROVIDER_DEFINITIONS, getAgentProviderDefinition };
+export interface ProviderDefinition extends AgentProviderDefinition {
+    enabled: boolean;
+    /**
+     * The id of another *registered* provider this one extends (e.g. a Z.AI
+     * profile that extends "claude"). null for built-in providers and for
+     * generic ACP providers (which only extend the literal "acp" sentinel).
+     */
+    derivedFromProviderId: string | null;
+    createClient: (logger: Logger) => AgentClient;
+    resolveCreateConfig: (input: ResolveAgentCreateConfigInput) => ResolveAgentCreateConfigResult;
+    isCreateConfigUnattended: (input: AgentCreateConfigUnattendedInput) => boolean;
+    /**
+     * Single catalog discovery call used by ProviderSnapshotManager. Should spawn
+     * at most one provider runtime process and return both models and modes.
+     */
+    fetchCatalog: (options: FetchCatalogOptions, client?: AgentClient) => Promise<ProviderCatalog>;
+}
+export interface BuildProviderRegistryOptions {
+    runtimeSettings?: AgentProviderRuntimeSettingsMap;
+    providerOverrides?: Record<string, ProviderOverride>;
+    workspaceGitService?: Pick<WorkspaceGitService, "resolveRepoRoot">;
+    managedProcesses?: ManagedProcessRegistry;
+    isDev?: boolean;
+}
+export declare function wrapSessionProvider(provider: AgentProvider, inner: AgentSession): AgentSession;
+export declare function buildProviderRegistry(logger: Logger, options?: BuildProviderRegistryOptions): Record<AgentProvider, ProviderDefinition>;
+export declare function getProviderIds(registry: Record<AgentProvider, ProviderDefinition>): AgentProvider[];
+export declare const PROVIDER_REGISTRY: Record<AgentProvider, ProviderDefinition>;
+export declare function createAllClients(logger: Logger, options?: BuildProviderRegistryOptions): Record<AgentProvider, AgentClient>;
+export declare function createClientsFromRegistry(registry: Record<AgentProvider, ProviderDefinition>, logger: Logger): Record<AgentProvider, AgentClient>;
+export declare function shutdownProviders(logger: Logger, options?: BuildProviderRegistryOptions): Promise<void>;
+export declare function shutdownAgentClients(clients: Iterable<AgentClient>, logger: Logger): Promise<void>;
+//# sourceMappingURL=provider-registry.d.ts.map