@maintainer-pro/ai-cli 0.1.5 → 0.1.7

package/dist/index.d.cts

@@ -52,7 +52,7 @@ interface CallAiOptions {
     /** Absolute paths to screenshot/image files the agent should inspect. */
     attachmentPaths?: string[];
     /**
-     * Compact excerpts from other `.maintainer-pro/chat` conversations.
+     * Compact excerpts from other project chats.
      * Injected into the prompt for the model to use when relevant.
      */
     priorConversationsContext?: string;
@@ -299,17 +299,25 @@ interface ChatStoreLike {
     }>): Promise<void>;
     /**
      * Optional remote/local upload hook. When present, chat images are persisted
-     * through the store instead of `.maintainer-pro/uploads`.
+     * through the store instead of the project data uploads folder.
      * `localPaths` are absolute paths for CLI inspection; `refs` are stored on messages.
      */
     uploadAttachments?(conversationId: string, attachments: ChatAttachment[] | undefined): Promise<{
         refs: string[];
         localPaths: string[];
     }>;
+    /**
+     * Download stored message images into the project data folder so the coding CLI can
+     * open them. Used on working turns where the chat POST has no image bytes.
+     */
+    materializeMessageAttachments?(conversationId: string, messageId: string | undefined, workspaceDir: string): Promise<string[]>;
 }
 interface ChatHandlerOptions {
     systemPrompt: string;
     workspaceDir?: string;
+    /** Bridge-owned data dir (~/.maintainer-pro/projects/<id>). */
+    dataDir?: string;
+    sandboxId?: string;
     providerPreference?: CallAiOptions["providerPreference"];
     providers?: AiProvider[];
     tools?: ToolSchemaMap;
@@ -328,8 +336,11 @@ declare function toNextRoute(handlers: ChatHandlers): {
     POST: (request: Request) => Promise<Response>;
 };
 
-/** Persist chat image attachments under the workspace and return absolute paths. */
-declare function saveChatAttachments(attachments: ChatAttachment[] | undefined, workspaceDir: string): Promise<string[]>;
+/** Persist chat image attachments under the project data dir and return absolute paths. */
+declare function saveChatAttachments(attachments: ChatAttachment[] | undefined, workspaceDir: string, extra?: {
+    dataDir?: string | null;
+    sandboxId?: string | null;
+}): Promise<string[]>;
 
 interface LocalStoredMessage {
     id: string;
@@ -371,6 +382,7 @@ type SyncedChatStore = ChatStoreLike & {
 };
 type RemoteStore = ChatStoreLike & {
     uploadAttachments?: NonNullable<ChatStoreLike["uploadAttachments"]>;
+    materializeMessageAttachments?: NonNullable<ChatStoreLike["materializeMessageAttachments"]>;
     listSnapshot?: () => Promise<CachedConversation[]>;
 };
 type WorkingTurnEvent = {
@@ -418,7 +430,7 @@ type UploadResult = {
     attachmentIds: string[];
 };
 /**
- * Persist chat data via Maintainer Pro HTTP API (no local .maintainer-pro writes).
+ * Persist chat data via Maintainer Pro HTTP API (no writes into the host app).
  */
 declare function createMaintainerProStore(options: MaintainerProStoreOptions): SyncedChatStore & {
     uploadAttachments: (conversationId: string, attachments: ChatAttachment[] | undefined) => Promise<UploadResult>;
@@ -472,6 +484,13 @@ interface WorkspaceInspectResult {
     provider: string;
     rawText: string;
 }
+/**
+ * Read-only config analysis for interactive onboarding.
+ * Never instructs the agent to edit the repo; times out so UI stays responsive.
+ */
+declare function inspectConfigOnly(input: WorkspaceInspectInput, opts?: {
+    timeoutMs?: number;
+}): Promise<WorkspaceInspectResult>;
 /**
  * Ask the coding-agent CLI (via callAi) to inspect a workspace and optionally
  * repair setup issues. Used by ai-bridge so host-process planning uses the
@@ -479,4 +498,155 @@ interface WorkspaceInspectResult {
  */
 declare function inspectAndRepairWorkspace(input: WorkspaceInspectInput): Promise<WorkspaceInspectResult>;
 
-export { ACCESS_IGNORE_BEGIN, ACCESS_IGNORE_END, type AiCliProviderId, type AiProvider, type AiResponse, type CachedChatMessage, type CachedConversation, type CallAiOptions, type ChatAttachment, type ChatHandlerOptions, type ChatHandlers, type ChatMessage, type ChatSenderType, type ChatStoreLike, type ChatUser, type ClientContext, DEFAULT_AI_IGNORE_PATHS, type LocalStoredMessage, type MaintainerProStoreOptions, PROMPT_SECTION, type ParentChainEntry, type ParentChainSource, type PriorConversationOptions, type ProviderPreference, type SyncedChatStore, type SyncedChatStoreOptions, type SyncedStoreStats, type ToolCall, type ToolSchemaMap, WORKING_PROVIDER, type WorkingTurnEvent, type WorkspaceInspectInput, type WorkspaceInspectResult, type WorkspaceKind, buildClaudeUserPrompt, buildConversationPrompt, buildCursorPrompt, buildPriorConversationsContext, callAi, collectParentChain, commandExists, createAntigravityProvider, createBuiltinProviders, createChatHandler, createClaudeProvider, createCursorProvider, createDefaultSystemPrompt, createInfoLogger, createLocalDirectoryStore, createLogger, createMaintainerProStore, createMaintainerProStoreFromEnv, createSyncedChatStore, createToolValidator, formatAccessPolicyPromptSection, formatClientContext, formatParentChainContext, getProviderPreference, inspectAndRepairWorkspace, isDevMode, isIgnoredRelative, isInsideWorkspace, isPathAllowed, normalizeIgnorePaths, parentChainForTurn, parseAiResponse, parseIgnorePathsEnv, previewText, providerLabel, renderManagedIgnoreBlock, resolveCliBinary, resolveIgnorePaths, resolveLogLevel, resolveProvider, saveChatAttachments, toNextRoute, upsertManagedIgnoreFile };
+/** Top-level folder under the user home (bridge.json, per-project data). */
+declare const MAINTAINER_PRO_HOME_DIR = ".maintainer-pro";
+declare const HOST_APPS_FILE = "apps.json";
+type ProjectDataInput = {
+    workspaceDir: string;
+    /** Distinguishes sandboxes when one bridge runs several apps. */
+    sandboxId?: string | null;
+    /** Absolute override (e.g. already resolved by the bridge). */
+    dataDir?: string | null;
+};
+declare function maintainerProHome(): string;
+declare function projectIdForFolder(folder: string): string;
+declare function sanitizeProjectId(id: string): string;
+/**
+ * Per-project data lives next to the bridge, not in the host app:
+ * `~/.maintainer-pro/projects/<sandboxId or folder-hash>/`.
+ */
+declare function resolveProjectDataDir(input: ProjectDataInput): string;
+declare function projectUploadsDir(input: ProjectDataInput): string;
+declare function hostAppsCachePath$1(input: ProjectDataInput): string;
+declare function ensureProjectDataDir(input: ProjectDataInput): string;
+
+/** @deprecated Host-apps cache lives under ~/.maintainer-pro/projects/<id>. */
+declare const COLLABORATER_DIR = ".collaborater";
+declare const AI_SERVER_APP_ID = "ai-server";
+declare const AI_SERVER_DEFAULT_PORT = 3100;
+type HostAppRole = "ai-server" | "ui" | "backend" | "app" | "custom";
+type HostAppSource = "default" | "env" | "package" | "ai" | "manual";
+type HostEnvMap = {
+    key: string;
+    sourceAppId: string;
+};
+type HostApp = {
+    id: string;
+    name: string;
+    role: HostAppRole;
+    port: number;
+    startCommand?: string | null;
+    source: HostAppSource;
+    locked?: boolean;
+    /** Share URL / CORS UI — the page the browser opens. */
+    host?: boolean;
+    envMaps?: HostEnvMap[];
+};
+type HostAppsResolveInput = {
+    workspaceDir: string;
+    appName?: string;
+    preferredAiPort?: number;
+    /** Desired list from Maintainer Pro — used as source of truth when present. */
+    desired?: HostApp[] | null;
+    /** Re-scan files / optionally ask the agent. */
+    force?: boolean;
+    /** Only call the coding-agent CLI when files are missing or conflicting. */
+    allowAi?: boolean;
+    sandboxId?: string | null;
+    dataDir?: string | null;
+};
+type HostAppsResolveResult = {
+    apps: HostApp[];
+    source: "desired" | "cache" | "env" | "ai" | "default";
+    cached: boolean;
+    usedAi: boolean;
+    confused: boolean;
+    reasons: string[];
+    fingerprint: string;
+};
+type SetupProposalConfidence = "high" | "medium" | "low";
+type HostAppAlternative = {
+    /** Primary app id this alternative can replace. */
+    appId: string;
+    port: number;
+    startCommand?: string | null;
+    label: string;
+    source: HostAppSource;
+};
+type SetupProposal = {
+    apps: HostApp[];
+    alternatives: HostAppAlternative[];
+    reasons: string[];
+    confidence: SetupProposalConfidence;
+    projectSummary: string;
+    usedAi: boolean;
+    needsReview: boolean;
+    fingerprint: string;
+};
+type ProposeHostAppsInput = {
+    workspaceDir: string;
+    appName?: string;
+    preferredAiPort?: number;
+    /**
+     * When true (default), call read-only AI if file detect is confused / low confidence.
+     * Never edits the repo.
+     */
+    allowAi?: boolean;
+};
+declare function parsePort(value: unknown, fallback?: number): number;
+declare function hostAppsCachePath(folder: string, extra?: {
+    sandboxId?: string | null;
+    dataDir?: string | null;
+}): string;
+declare function defaultAiServerApp(port?: number): HostApp;
+declare function normalizeHostApp(raw: unknown): HostApp | null;
+declare function normalizeEnvMaps(raw: unknown): HostEnvMap[];
+declare function ensureSingleHost(apps: HostApp[]): HostApp[];
+declare function normalizeHostApps(raw: unknown): HostApp[];
+declare function ensureAiServerApp(apps: HostApp[], preferredPort?: number): HostApp[];
+declare function readProjectEnvLayers(folder: string): {
+    merged: Record<string, string>;
+    layers: Array<{
+        file: string;
+        values: Record<string, string>;
+    }>;
+};
+declare function hostAppsFingerprint(folder: string): string;
+declare function detectHostAppsFromFiles(folder: string, opts?: {
+    preferredAiPort?: number;
+    appName?: string;
+}): {
+    apps: HostApp[];
+    reasons: string[];
+    confused: boolean;
+};
+declare function readHostAppsCache(folder: string, extra?: {
+    sandboxId?: string | null;
+    dataDir?: string | null;
+}): {
+    apps: HostApp[];
+    fingerprint?: string;
+    updatedAt?: string;
+} | null;
+/** @deprecated Use readHostAppsCache. */
+declare const readCollaboraterApps: typeof readHostAppsCache;
+declare function writeHostAppsCache(folder: string, apps: HostApp[], extra?: Record<string, unknown>, loc?: {
+    sandboxId?: string | null;
+    dataDir?: string | null;
+}): void;
+/** @deprecated Use writeHostAppsCache. */
+declare const writeCollaboraterApps: typeof writeHostAppsCache;
+declare function mergeDesiredHostApps(desired: HostApp[], detected: HostApp[]): HostApp[];
+/**
+ * Fast, interactive onboarding propose: file detect first, optional read-only AI.
+ * Never edits the repository.
+ */
+declare function proposeHostAppsFromConfig(input: ProposeHostAppsInput): Promise<SetupProposal>;
+/**
+ * Resolve host apps without calling the coding-agent CLI unless files are
+ * missing, conflicting, or the caller forced a redetect.
+ * When allowAi is set, uses read-only config inspect (does not edit the repo).
+ */
+declare function resolveHostApps(input: HostAppsResolveInput): Promise<HostAppsResolveResult>;
+
+export { ACCESS_IGNORE_BEGIN, ACCESS_IGNORE_END, AI_SERVER_APP_ID, AI_SERVER_DEFAULT_PORT, type AiCliProviderId, type AiProvider, type AiResponse, COLLABORATER_DIR, type CachedChatMessage, type CachedConversation, type CallAiOptions, type ChatAttachment, type ChatHandlerOptions, type ChatHandlers, type ChatMessage, type ChatSenderType, type ChatStoreLike, type ChatUser, type ClientContext, DEFAULT_AI_IGNORE_PATHS, HOST_APPS_FILE, type HostApp, type HostAppAlternative, type HostAppRole, type HostAppSource, type HostAppsResolveInput, type HostAppsResolveResult, type HostEnvMap, type LocalStoredMessage, MAINTAINER_PRO_HOME_DIR, type MaintainerProStoreOptions, PROMPT_SECTION, type ParentChainEntry, type ParentChainSource, type PriorConversationOptions, type ProjectDataInput, type ProposeHostAppsInput, type ProviderPreference, type SetupProposal, type SetupProposalConfidence, type SyncedChatStore, type SyncedChatStoreOptions, type SyncedStoreStats, type ToolCall, type ToolSchemaMap, WORKING_PROVIDER, type WorkingTurnEvent, type WorkspaceInspectInput, type WorkspaceInspectResult, type WorkspaceKind, buildClaudeUserPrompt, buildConversationPrompt, buildCursorPrompt, buildPriorConversationsContext, callAi, collectParentChain, commandExists, createAntigravityProvider, createBuiltinProviders, createChatHandler, createClaudeProvider, createCursorProvider, createDefaultSystemPrompt, createInfoLogger, createLocalDirectoryStore, createLogger, createMaintainerProStore, createMaintainerProStoreFromEnv, createSyncedChatStore, createToolValidator, defaultAiServerApp, detectHostAppsFromFiles, ensureAiServerApp, ensureProjectDataDir, ensureSingleHost, formatAccessPolicyPromptSection, formatClientContext, formatParentChainContext, getProviderPreference, hostAppsCachePath, hostAppsFingerprint, inspectAndRepairWorkspace, inspectConfigOnly, isDevMode, isIgnoredRelative, isInsideWorkspace, isPathAllowed, maintainerProHome, mergeDesiredHostApps, normalizeEnvMaps, normalizeHostApp, normalizeHostApps, normalizeIgnorePaths, parentChainForTurn, parseAiResponse, parseIgnorePathsEnv, parsePort, previewText, hostAppsCachePath$1 as projectHostAppsPath, projectIdForFolder, projectUploadsDir, proposeHostAppsFromConfig, providerLabel, readCollaboraterApps, readHostAppsCache, readProjectEnvLayers, renderManagedIgnoreBlock, resolveCliBinary, resolveHostApps, resolveIgnorePaths, resolveLogLevel, resolveProjectDataDir, resolveProvider, sanitizeProjectId, saveChatAttachments, toNextRoute, upsertManagedIgnoreFile, writeCollaboraterApps, writeHostAppsCache };

package/dist/index.d.ts

@@ -52,7 +52,7 @@ interface CallAiOptions {
     /** Absolute paths to screenshot/image files the agent should inspect. */
     attachmentPaths?: string[];
     /**
-     * Compact excerpts from other `.maintainer-pro/chat` conversations.
+     * Compact excerpts from other project chats.
      * Injected into the prompt for the model to use when relevant.
      */
     priorConversationsContext?: string;
@@ -299,17 +299,25 @@ interface ChatStoreLike {
     }>): Promise<void>;
     /**
      * Optional remote/local upload hook. When present, chat images are persisted
-     * through the store instead of `.maintainer-pro/uploads`.
+     * through the store instead of the project data uploads folder.
      * `localPaths` are absolute paths for CLI inspection; `refs` are stored on messages.
      */
     uploadAttachments?(conversationId: string, attachments: ChatAttachment[] | undefined): Promise<{
         refs: string[];
         localPaths: string[];
     }>;
+    /**
+     * Download stored message images into the project data folder so the coding CLI can
+     * open them. Used on working turns where the chat POST has no image bytes.
+     */
+    materializeMessageAttachments?(conversationId: string, messageId: string | undefined, workspaceDir: string): Promise<string[]>;
 }
 interface ChatHandlerOptions {
     systemPrompt: string;
     workspaceDir?: string;
+    /** Bridge-owned data dir (~/.maintainer-pro/projects/<id>). */
+    dataDir?: string;
+    sandboxId?: string;
     providerPreference?: CallAiOptions["providerPreference"];
     providers?: AiProvider[];
     tools?: ToolSchemaMap;
@@ -328,8 +336,11 @@ declare function toNextRoute(handlers: ChatHandlers): {
     POST: (request: Request) => Promise<Response>;
 };
 
-/** Persist chat image attachments under the workspace and return absolute paths. */
-declare function saveChatAttachments(attachments: ChatAttachment[] | undefined, workspaceDir: string): Promise<string[]>;
+/** Persist chat image attachments under the project data dir and return absolute paths. */
+declare function saveChatAttachments(attachments: ChatAttachment[] | undefined, workspaceDir: string, extra?: {
+    dataDir?: string | null;
+    sandboxId?: string | null;
+}): Promise<string[]>;
 
 interface LocalStoredMessage {
     id: string;
@@ -371,6 +382,7 @@ type SyncedChatStore = ChatStoreLike & {
 };
 type RemoteStore = ChatStoreLike & {
     uploadAttachments?: NonNullable<ChatStoreLike["uploadAttachments"]>;
+    materializeMessageAttachments?: NonNullable<ChatStoreLike["materializeMessageAttachments"]>;
     listSnapshot?: () => Promise<CachedConversation[]>;
 };
 type WorkingTurnEvent = {
@@ -418,7 +430,7 @@ type UploadResult = {
     attachmentIds: string[];
 };
 /**
- * Persist chat data via Maintainer Pro HTTP API (no local .maintainer-pro writes).
+ * Persist chat data via Maintainer Pro HTTP API (no writes into the host app).
  */
 declare function createMaintainerProStore(options: MaintainerProStoreOptions): SyncedChatStore & {
     uploadAttachments: (conversationId: string, attachments: ChatAttachment[] | undefined) => Promise<UploadResult>;
@@ -472,6 +484,13 @@ interface WorkspaceInspectResult {
     provider: string;
     rawText: string;
 }
+/**
+ * Read-only config analysis for interactive onboarding.
+ * Never instructs the agent to edit the repo; times out so UI stays responsive.
+ */
+declare function inspectConfigOnly(input: WorkspaceInspectInput, opts?: {
+    timeoutMs?: number;
+}): Promise<WorkspaceInspectResult>;
 /**
  * Ask the coding-agent CLI (via callAi) to inspect a workspace and optionally
  * repair setup issues. Used by ai-bridge so host-process planning uses the
@@ -479,4 +498,155 @@ interface WorkspaceInspectResult {
  */
 declare function inspectAndRepairWorkspace(input: WorkspaceInspectInput): Promise<WorkspaceInspectResult>;
 
-export { ACCESS_IGNORE_BEGIN, ACCESS_IGNORE_END, type AiCliProviderId, type AiProvider, type AiResponse, type CachedChatMessage, type CachedConversation, type CallAiOptions, type ChatAttachment, type ChatHandlerOptions, type ChatHandlers, type ChatMessage, type ChatSenderType, type ChatStoreLike, type ChatUser, type ClientContext, DEFAULT_AI_IGNORE_PATHS, type LocalStoredMessage, type MaintainerProStoreOptions, PROMPT_SECTION, type ParentChainEntry, type ParentChainSource, type PriorConversationOptions, type ProviderPreference, type SyncedChatStore, type SyncedChatStoreOptions, type SyncedStoreStats, type ToolCall, type ToolSchemaMap, WORKING_PROVIDER, type WorkingTurnEvent, type WorkspaceInspectInput, type WorkspaceInspectResult, type WorkspaceKind, buildClaudeUserPrompt, buildConversationPrompt, buildCursorPrompt, buildPriorConversationsContext, callAi, collectParentChain, commandExists, createAntigravityProvider, createBuiltinProviders, createChatHandler, createClaudeProvider, createCursorProvider, createDefaultSystemPrompt, createInfoLogger, createLocalDirectoryStore, createLogger, createMaintainerProStore, createMaintainerProStoreFromEnv, createSyncedChatStore, createToolValidator, formatAccessPolicyPromptSection, formatClientContext, formatParentChainContext, getProviderPreference, inspectAndRepairWorkspace, isDevMode, isIgnoredRelative, isInsideWorkspace, isPathAllowed, normalizeIgnorePaths, parentChainForTurn, parseAiResponse, parseIgnorePathsEnv, previewText, providerLabel, renderManagedIgnoreBlock, resolveCliBinary, resolveIgnorePaths, resolveLogLevel, resolveProvider, saveChatAttachments, toNextRoute, upsertManagedIgnoreFile };
+/** Top-level folder under the user home (bridge.json, per-project data). */
+declare const MAINTAINER_PRO_HOME_DIR = ".maintainer-pro";
+declare const HOST_APPS_FILE = "apps.json";
+type ProjectDataInput = {
+    workspaceDir: string;
+    /** Distinguishes sandboxes when one bridge runs several apps. */
+    sandboxId?: string | null;
+    /** Absolute override (e.g. already resolved by the bridge). */
+    dataDir?: string | null;
+};
+declare function maintainerProHome(): string;
+declare function projectIdForFolder(folder: string): string;
+declare function sanitizeProjectId(id: string): string;
+/**
+ * Per-project data lives next to the bridge, not in the host app:
+ * `~/.maintainer-pro/projects/<sandboxId or folder-hash>/`.
+ */
+declare function resolveProjectDataDir(input: ProjectDataInput): string;
+declare function projectUploadsDir(input: ProjectDataInput): string;
+declare function hostAppsCachePath$1(input: ProjectDataInput): string;
+declare function ensureProjectDataDir(input: ProjectDataInput): string;
+
+/** @deprecated Host-apps cache lives under ~/.maintainer-pro/projects/<id>. */
+declare const COLLABORATER_DIR = ".collaborater";
+declare const AI_SERVER_APP_ID = "ai-server";
+declare const AI_SERVER_DEFAULT_PORT = 3100;
+type HostAppRole = "ai-server" | "ui" | "backend" | "app" | "custom";
+type HostAppSource = "default" | "env" | "package" | "ai" | "manual";
+type HostEnvMap = {
+    key: string;
+    sourceAppId: string;
+};
+type HostApp = {
+    id: string;
+    name: string;
+    role: HostAppRole;
+    port: number;
+    startCommand?: string | null;
+    source: HostAppSource;
+    locked?: boolean;
+    /** Share URL / CORS UI — the page the browser opens. */
+    host?: boolean;
+    envMaps?: HostEnvMap[];
+};
+type HostAppsResolveInput = {
+    workspaceDir: string;
+    appName?: string;
+    preferredAiPort?: number;
+    /** Desired list from Maintainer Pro — used as source of truth when present. */
+    desired?: HostApp[] | null;
+    /** Re-scan files / optionally ask the agent. */
+    force?: boolean;
+    /** Only call the coding-agent CLI when files are missing or conflicting. */
+    allowAi?: boolean;
+    sandboxId?: string | null;
+    dataDir?: string | null;
+};
+type HostAppsResolveResult = {
+    apps: HostApp[];
+    source: "desired" | "cache" | "env" | "ai" | "default";
+    cached: boolean;
+    usedAi: boolean;
+    confused: boolean;
+    reasons: string[];
+    fingerprint: string;
+};
+type SetupProposalConfidence = "high" | "medium" | "low";
+type HostAppAlternative = {
+    /** Primary app id this alternative can replace. */
+    appId: string;
+    port: number;
+    startCommand?: string | null;
+    label: string;
+    source: HostAppSource;
+};
+type SetupProposal = {
+    apps: HostApp[];
+    alternatives: HostAppAlternative[];
+    reasons: string[];
+    confidence: SetupProposalConfidence;
+    projectSummary: string;
+    usedAi: boolean;
+    needsReview: boolean;
+    fingerprint: string;
+};
+type ProposeHostAppsInput = {
+    workspaceDir: string;
+    appName?: string;
+    preferredAiPort?: number;
+    /**
+     * When true (default), call read-only AI if file detect is confused / low confidence.
+     * Never edits the repo.
+     */
+    allowAi?: boolean;
+};
+declare function parsePort(value: unknown, fallback?: number): number;
+declare function hostAppsCachePath(folder: string, extra?: {
+    sandboxId?: string | null;
+    dataDir?: string | null;
+}): string;
+declare function defaultAiServerApp(port?: number): HostApp;
+declare function normalizeHostApp(raw: unknown): HostApp | null;
+declare function normalizeEnvMaps(raw: unknown): HostEnvMap[];
+declare function ensureSingleHost(apps: HostApp[]): HostApp[];
+declare function normalizeHostApps(raw: unknown): HostApp[];
+declare function ensureAiServerApp(apps: HostApp[], preferredPort?: number): HostApp[];
+declare function readProjectEnvLayers(folder: string): {
+    merged: Record<string, string>;
+    layers: Array<{
+        file: string;
+        values: Record<string, string>;
+    }>;
+};
+declare function hostAppsFingerprint(folder: string): string;
+declare function detectHostAppsFromFiles(folder: string, opts?: {
+    preferredAiPort?: number;
+    appName?: string;
+}): {
+    apps: HostApp[];
+    reasons: string[];
+    confused: boolean;
+};
+declare function readHostAppsCache(folder: string, extra?: {
+    sandboxId?: string | null;
+    dataDir?: string | null;
+}): {
+    apps: HostApp[];
+    fingerprint?: string;
+    updatedAt?: string;
+} | null;
+/** @deprecated Use readHostAppsCache. */
+declare const readCollaboraterApps: typeof readHostAppsCache;
+declare function writeHostAppsCache(folder: string, apps: HostApp[], extra?: Record<string, unknown>, loc?: {
+    sandboxId?: string | null;
+    dataDir?: string | null;
+}): void;
+/** @deprecated Use writeHostAppsCache. */
+declare const writeCollaboraterApps: typeof writeHostAppsCache;
+declare function mergeDesiredHostApps(desired: HostApp[], detected: HostApp[]): HostApp[];
+/**
+ * Fast, interactive onboarding propose: file detect first, optional read-only AI.
+ * Never edits the repository.
+ */
+declare function proposeHostAppsFromConfig(input: ProposeHostAppsInput): Promise<SetupProposal>;
+/**
+ * Resolve host apps without calling the coding-agent CLI unless files are
+ * missing, conflicting, or the caller forced a redetect.
+ * When allowAi is set, uses read-only config inspect (does not edit the repo).
+ */
+declare function resolveHostApps(input: HostAppsResolveInput): Promise<HostAppsResolveResult>;
+
+export { ACCESS_IGNORE_BEGIN, ACCESS_IGNORE_END, AI_SERVER_APP_ID, AI_SERVER_DEFAULT_PORT, type AiCliProviderId, type AiProvider, type AiResponse, COLLABORATER_DIR, type CachedChatMessage, type CachedConversation, type CallAiOptions, type ChatAttachment, type ChatHandlerOptions, type ChatHandlers, type ChatMessage, type ChatSenderType, type ChatStoreLike, type ChatUser, type ClientContext, DEFAULT_AI_IGNORE_PATHS, HOST_APPS_FILE, type HostApp, type HostAppAlternative, type HostAppRole, type HostAppSource, type HostAppsResolveInput, type HostAppsResolveResult, type HostEnvMap, type LocalStoredMessage, MAINTAINER_PRO_HOME_DIR, type MaintainerProStoreOptions, PROMPT_SECTION, type ParentChainEntry, type ParentChainSource, type PriorConversationOptions, type ProjectDataInput, type ProposeHostAppsInput, type ProviderPreference, type SetupProposal, type SetupProposalConfidence, type SyncedChatStore, type SyncedChatStoreOptions, type SyncedStoreStats, type ToolCall, type ToolSchemaMap, WORKING_PROVIDER, type WorkingTurnEvent, type WorkspaceInspectInput, type WorkspaceInspectResult, type WorkspaceKind, buildClaudeUserPrompt, buildConversationPrompt, buildCursorPrompt, buildPriorConversationsContext, callAi, collectParentChain, commandExists, createAntigravityProvider, createBuiltinProviders, createChatHandler, createClaudeProvider, createCursorProvider, createDefaultSystemPrompt, createInfoLogger, createLocalDirectoryStore, createLogger, createMaintainerProStore, createMaintainerProStoreFromEnv, createSyncedChatStore, createToolValidator, defaultAiServerApp, detectHostAppsFromFiles, ensureAiServerApp, ensureProjectDataDir, ensureSingleHost, formatAccessPolicyPromptSection, formatClientContext, formatParentChainContext, getProviderPreference, hostAppsCachePath, hostAppsFingerprint, inspectAndRepairWorkspace, inspectConfigOnly, isDevMode, isIgnoredRelative, isInsideWorkspace, isPathAllowed, maintainerProHome, mergeDesiredHostApps, normalizeEnvMaps, normalizeHostApp, normalizeHostApps, normalizeIgnorePaths, parentChainForTurn, parseAiResponse, parseIgnorePathsEnv, parsePort, previewText, hostAppsCachePath$1 as projectHostAppsPath, projectIdForFolder, projectUploadsDir, proposeHostAppsFromConfig, providerLabel, readCollaboraterApps, readHostAppsCache, readProjectEnvLayers, renderManagedIgnoreBlock, resolveCliBinary, resolveHostApps, resolveIgnorePaths, resolveLogLevel, resolveProjectDataDir, resolveProvider, sanitizeProjectId, saveChatAttachments, toNextRoute, upsertManagedIgnoreFile, writeCollaboraterApps, writeHostAppsCache };