@maintainer-pro/ai-cli 0.1.2 → 0.1.4

package/README.md

@@ -58,6 +58,5 @@ Chat history is stored in Maintainer Pro admin. Do not put API keys in the brows
 |---------|------|
 | [`@maintainer-pro/ai-server`](https://www.npmjs.com/package/@maintainer-pro/ai-server) | Local Node chat server (sidecar) that uses this SDK |
 | [`@maintainer-pro/ai-ui`](https://www.npmjs.com/package/@maintainer-pro/ai-ui) | Embed widget (`ai-ui.iife.js`) — sidecar in dev, static file in prod |
-| [`@maintainer-pro/setup`](https://www.npmjs.com/package/@maintainer-pro/setup) | Download the sandbox setup guide |
 
 Optional SQL persistence lives on `@maintainer-pro/ai-cli/db` (install `better-sqlite3`, `postgres`, or `mysql2`).

package/dist/index.cjs

@@ -30,6 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  WORKING_PROVIDER: () => WORKING_PROVIDER,
   buildClaudeUserPrompt: () => buildClaudeUserPrompt,
   buildConversationPrompt: () => buildConversationPrompt,
   buildCursorPrompt: () => buildCursorPrompt,
@@ -48,6 +49,7 @@ __export(index_exports, {
   createToolValidator: () => createToolValidator,
   formatClientContext: () => formatClientContext,
   getProviderPreference: () => getProviderPreference,
+  inspectAndRepairWorkspace: () => inspectAndRepairWorkspace,
   parseAiResponse: () => parseAiResponse,
   providerLabel: () => providerLabel,
   resolveCliBinary: () => resolveCliBinary,
@@ -102,7 +104,7 @@ function splitMessages(messages) {
   const history = latestUserIndex > 0 ? messages.slice(0, latestUserIndex) : [];
   return { request, history };
 }
-function buildUserFacingPrompt(systemPrompt, messages, context, attachmentPaths, priorConversationsContext) {
+function buildUserFacingPrompt(systemPrompt, messages, context, attachmentPaths, priorConversationsContext, technical) {
   const { request, history } = splitMessages(messages);
   const historyBlock = history.length > 0 ? `Conversation so far:
 ${buildConversationPrompt(history)}
@@ -122,27 +124,30 @@ ${buildConversationPrompt(history)}
 ${attachmentPaths.map((p) => `- ${p}`).join("\n")}
 
 ` : "";
+  const closer = technical ? "Do the work now. Follow the requested output format exactly." : "Do the work now (or ask one short clarifying question if needed). Reply in English, non-technical and user-facing. If it's not resolving, offer a quick call.";
   return `${systemSection}${contextSection}${priorSection}${historyBlock}${attachmentsSection}Current user request:
 ${request || "(See the attached screenshot(s).)"}
 
-Do the work now (or ask one short clarifying question if needed). Reply in English, non-technical and user-facing. If it's not resolving, offer a quick call.`;
+${closer}`;
 }
-function buildCursorPrompt(systemPrompt, messages, context, attachmentPaths, priorConversationsContext) {
+function buildCursorPrompt(systemPrompt, messages, context, attachmentPaths, priorConversationsContext, technical) {
   return buildUserFacingPrompt(
     systemPrompt,
     messages,
     context,
     attachmentPaths,
-    priorConversationsContext
+    priorConversationsContext,
+    technical
   );
 }
-function buildClaudeUserPrompt(messages, context, attachmentPaths, priorConversationsContext) {
+function buildClaudeUserPrompt(messages, context, attachmentPaths, priorConversationsContext, technical) {
   return buildUserFacingPrompt(
     null,
     messages,
     context,
     attachmentPaths,
-    priorConversationsContext
+    priorConversationsContext,
+    technical
   );
 }
 
@@ -255,7 +260,8 @@ async function callClaudeCli(command, messages, context, options) {
     messages,
     context,
     options.attachmentPaths,
-    options.priorConversationsContext
+    options.priorConversationsContext,
+    options.technical
   );
   const resolved = resolveCliCommand("claude", command);
   const workspace = options.workspaceDir ?? process.env.AI_CLI_WORKSPACE ?? process.cwd();
@@ -294,7 +300,8 @@ async function callCursorCli(command, messages, context, options) {
     messages,
     context,
     options.attachmentPaths,
-    options.priorConversationsContext
+    options.priorConversationsContext,
+    options.technical
   );
   const resolved = resolveCliCommand("cursor", command);
   const workspace = options.workspaceDir ?? process.env.AI_CLI_WORKSPACE ?? process.cwd();
@@ -335,7 +342,8 @@ async function callAntigravityCli(command, messages, context, options) {
     messages,
     context,
     options.attachmentPaths,
-    options.priorConversationsContext
+    options.priorConversationsContext,
+    options.technical
   );
   const prompt = `You are operating as a coding agent with full permission to read and edit files in this workspace. Do not introduce yourself. Do not ask what you are. Execute the user's latest request now (edit files and/or emit runtime tool JSON as instructed).
 
@@ -592,7 +600,9 @@ async function buildPriorConversationsContext(db, options) {
   ).slice(0, maxConversations) : ranked;
   const blocks = selected.map((c) => {
     const slice = c.messages.length > maxMessages ? c.messages.slice(-maxMessages) : c.messages;
-    const lines = slice.filter((m) => m.role === "user" || m.role === "assistant").map(
+    const lines = slice.filter(
+      (m) => (m.role === "user" || m.role === "assistant") && m.provider !== "working" && Boolean(m.content?.trim())
+    ).map(
       (m) => `${m.role === "user" ? "Human" : "Assistant"}: ${truncate(m.content)}`
     );
     const when = c.updatedAt ? ` (updated ${c.updatedAt.slice(0, 10)})` : "";
@@ -625,6 +635,18 @@ function createToolValidator(schemas) {
 }
 
 // src/http/handler.ts
+var WORKING_PROVIDER = "working";
+async function setWorkingMessage(db, conversationId) {
+  await db.ensureConversation(conversationId);
+  await db.clearWorkingMessages?.(conversationId);
+  await db.saveMessage({
+    conversationId,
+    role: "assistant",
+    content: "",
+    provider: WORKING_PROVIDER,
+    senderType: "ai"
+  });
+}
 var SHARED_CONVERSATION_ID = "shared";
 var conversationTurnSeq = /* @__PURE__ */ new Map();
 function beginConversationTurn(conversationId) {
@@ -697,6 +719,8 @@ function createChatHandler(options) {
       }
     },
     async POST(request) {
+      let trackedConversationId;
+      let trackedTurn = 0;
       try {
         const body = await request.json();
         const conversationId = await resolveSharedConversationId(
@@ -704,21 +728,16 @@ function createChatHandler(options) {
           options,
           body.conversationId
         );
-        if (body.type === "status") {
-          const content = body.content?.trim();
-          if (!conversationId || !content) {
+        trackedConversationId = conversationId;
+        if (body.type === "working-clear") {
+          if (!conversationId) {
             return Response.json(
-              { error: "conversationId and content are required" },
+              { error: "conversationId is required" },
               { status: 400 }
             );
           }
-          if (options.db) {
-            await options.db.ensureConversation(conversationId);
-            await options.db.saveMessage({
-              conversationId,
-              role: "assistant",
-              content
-            });
+          if (options.db?.clearWorkingMessages) {
+            await options.db.clearWorkingMessages(conversationId);
           }
           return Response.json({ ok: true, conversationId });
         }
@@ -766,7 +785,8 @@ function createChatHandler(options) {
           );
           persistAttachmentPaths = attachmentPaths;
         }
-        const turn = beginConversationTurn(conversationId);
+        const turn = beginConversationTurn(conversationId ?? SHARED_CONVERSATION_ID);
+        trackedTurn = turn;
         const signal = request.signal;
         if (options.db && conversationId) {
           const latest = messages[messages.length - 1];
@@ -782,13 +802,26 @@ function createChatHandler(options) {
               senderName: body.senderName?.trim() || void 0
             });
           }
+          await setWorkingMessage(options.db, conversationId);
         }
         const latestUser = [...messages].reverse().find((m) => m.role === "user");
         const priorConversationsContext = options.db ? await buildPriorConversationsContext(options.db, {
           excludeConversationId: conversationId,
           currentRequest: latestUser?.content ?? ""
         }) : "";
-        if (signal.aborted || !isActiveConversationTurn(conversationId, turn)) {
+        if (!isActiveConversationTurn(
+          conversationId ?? SHARED_CONVERSATION_ID,
+          turn
+        )) {
+          return Response.json({
+            superseded: true,
+            conversationId: conversationId ?? null
+          });
+        }
+        if (signal.aborted) {
+          if (options.db?.clearWorkingMessages && conversationId) {
+            await options.db.clearWorkingMessages(conversationId);
+          }
           return Response.json({
             superseded: true,
             conversationId: conversationId ?? null
@@ -799,7 +832,10 @@ function createChatHandler(options) {
           attachmentPaths,
           priorConversationsContext: priorConversationsContext || void 0
         });
-        if (!isActiveConversationTurn(conversationId, turn)) {
+        if (!isActiveConversationTurn(
+          conversationId ?? SHARED_CONVERSATION_ID,
+          turn
+        )) {
           return Response.json({
             superseded: true,
             conversationId: conversationId ?? null
@@ -811,6 +847,7 @@ function createChatHandler(options) {
         }
         if (options.db && conversationId) {
           await options.db.ensureConversation(conversationId);
+          await options.db.clearWorkingMessages?.(conversationId);
           await options.db.saveMessage({
             conversationId,
             role: "assistant",
@@ -834,6 +871,11 @@ function createChatHandler(options) {
         });
       } catch (err) {
         console.error("Chat API error:", err);
+        if (trackedConversationId && options.db?.clearWorkingMessages && isActiveConversationTurn(trackedConversationId, trackedTurn)) {
+          await options.db.clearWorkingMessages(trackedConversationId).catch(
+            () => void 0
+          );
+        }
         return Response.json(
           {
             error: "Sorry about that \u2014 I couldn't finish this right now. Happy to jump on a quick call if you'd like help \u2014 just let us know when works."
@@ -903,6 +945,16 @@ function createLocalDirectoryStore(baseDir) {
       await writeConversation(filePath, existing);
       return message;
     },
+    async clearWorkingMessages(conversationId) {
+      const filePath = fileFor(conversationId);
+      const existing = await readConversation(filePath);
+      if (!existing) return;
+      const next = existing.messages.filter((m) => m.provider !== "working");
+      if (next.length === existing.messages.length) return;
+      existing.messages = next;
+      existing.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+      await writeConversation(filePath, existing);
+    },
     async listMessages(conversationId) {
       const existing = await readConversation(fileFor(conversationId));
       return existing?.messages ?? [];
@@ -1009,6 +1061,15 @@ function createMaintainerProStore(options) {
       );
       return data.message;
     },
+    async clearWorkingMessages(conversationId) {
+      await mpFetch(
+        baseUrl,
+        apiKey,
+        `/api/v1/store/conversations/${encodeURIComponent(conversationId)}/messages?provider=working`,
+        { method: "DELETE" },
+        fetchImpl
+      );
+    },
     async listMessages(conversationId) {
       const data = await mpFetch(
         baseUrl,
@@ -1088,8 +1149,115 @@ function createMaintainerProStoreFromEnv() {
   if (!baseUrl || !apiKey) return null;
   return createMaintainerProStore({ baseUrl, apiKey });
 }
+
+// src/workspace-inspect.ts
+var import_zod = require("zod");
+var inspectJsonSchema = import_zod.z.object({
+  kind: import_zod.z.enum(["next", "vite", "html", "empty", "other"]).optional(),
+  name: import_zod.z.string().max(200).optional(),
+  summary: import_zod.z.string().max(800).optional(),
+  scripts: import_zod.z.object({
+    ui: import_zod.z.string().min(1).max(64).optional(),
+    backend: import_zod.z.string().min(1).max(64).optional(),
+    app: import_zod.z.string().min(1).max(64).optional()
+  }).optional(),
+  ports: import_zod.z.object({
+    ui: import_zod.z.number().int().min(1).max(65535).optional(),
+    backend: import_zod.z.number().int().min(1).max(65535).optional(),
+    app: import_zod.z.number().int().min(1).max(65535).optional()
+  }).optional(),
+  issues: import_zod.z.array(import_zod.z.string().max(500)).max(20).optional(),
+  fixes: import_zod.z.array(import_zod.z.string().max(500)).max(20).optional(),
+  ready: import_zod.z.boolean().optional()
+});
+function extractInspectJson(text) {
+  const fence = text.match(/```json\s*([\s\S]*?)```/i);
+  const raw = fence?.[1]?.trim() || text.match(/\{[\s\S]*\}/)?.[0];
+  if (!raw) return null;
+  try {
+    const parsed = inspectJsonSchema.safeParse(JSON.parse(raw));
+    return parsed.success ? parsed.data : null;
+  } catch {
+    return null;
+  }
+}
+function setupSystemPrompt(input) {
+  return `You are Maintainer Pro's local setup assistant on the developer's machine.
+
+Workspace: ${input.workspaceDir}
+App name: ${input.appName || "the app"}
+
+Inspect this repository (package.json, README, lockfiles, existing env files, how the UI and API start).
+You MAY edit files to fix setup problems that would block local run or the chat widget (env keys, widget mount, missing config).
+Do NOT start long-lived dev servers, tunnels, or install global tools.
+Do NOT run \`npm run dev\` or similar.
+
+Script names you report MUST already exist in package.json. Omit chat/ai-server scripts.
+
+End with a short human summary AND one \`\`\`json fence with:
+
+{
+  "kind": "next" | "vite" | "html" | "empty" | "other",
+  "name": "package or folder name",
+  "summary": "one sentence about this project",
+  "scripts": { "ui": "dev:client", "backend": "dev:server" },
+  "ports": { "ui": 5173, "backend": 4100 },
+  "issues": ["remaining problems"],
+  "fixes": ["what you changed"],
+  "ready": true
+}`;
+}
+function setupUserMessage(input) {
+  if (input.problem?.trim()) {
+    return `The local bridge failed to keep this project running:
+
+${input.problem.trim()}
+
+${input.extraContext ? `${input.extraContext.trim()}
+
+` : ""}Inspect the repo, fix the cause if you can, and return the JSON report.`;
+  }
+  return `${input.extraContext ? `${input.extraContext.trim()}
+
+` : ""}Inspect this project, fix any setup gaps you can, and return the JSON report.`;
+}
+async function inspectAndRepairWorkspace(input) {
+  const workspaceDir = input.workspaceDir;
+  const provider = await resolveProvider({ preference: "auto" });
+  const response = await callAi(
+    [{ role: "user", content: setupUserMessage(input) }],
+    {
+      route: "/local-setup",
+      pageTitle: input.appName || "Local setup",
+      relevantFiles: ["package.json", "README.md", ".env", ".env.example"],
+      data: {
+        workspaceDir,
+        problem: input.problem || null
+      }
+    },
+    {
+      systemPrompt: setupSystemPrompt(input),
+      workspaceDir,
+      technical: true
+    }
+  );
+  const parsed = extractInspectJson(response.text);
+  return {
+    kind: parsed?.kind ?? "other",
+    name: parsed?.name?.trim() || input.appName || "",
+    summary: parsed?.summary?.trim() || response.text.replace(/```json[\s\S]*```/i, "").trim().slice(0, 400),
+    scripts: parsed?.scripts ?? {},
+    ports: parsed?.ports ?? {},
+    issues: parsed?.issues ?? [],
+    fixes: parsed?.fixes ?? [],
+    ready: parsed?.ready ?? parsed?.issues?.length === 0,
+    provider: response.provider || provider.id,
+    rawText: response.text
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  WORKING_PROVIDER,
   buildClaudeUserPrompt,
   buildConversationPrompt,
   buildCursorPrompt,
@@ -1108,6 +1276,7 @@ function createMaintainerProStoreFromEnv() {
   createToolValidator,
   formatClientContext,
   getProviderPreference,
+  inspectAndRepairWorkspace,
   parseAiResponse,
   providerLabel,
   resolveCliBinary,

package/dist/index.d.cts

@@ -56,6 +56,8 @@ interface CallAiOptions {
     priorConversationsContext?: string;
     /** Extra / override providers (e.g. future HTTP model backends). */
     providers?: AiProvider[];
+    /** When true, skip the end-user chat footer so the agent can return structured output. */
+    technical?: boolean;
 }
 interface AiProvider {
     id: string;
@@ -85,9 +87,9 @@ declare function parseAiResponse(raw: string, provider: AiCliProviderId): AiResp
 declare function buildConversationPrompt(messages: ChatMessage[]): string;
 declare function formatClientContext(context?: ClientContext): string;
 /** Full prompt for providers without a native --system-prompt flag (Cursor). */
-declare function buildCursorPrompt(systemPrompt: string, messages: ChatMessage[], context?: ClientContext, attachmentPaths?: string[], priorConversationsContext?: string): string;
+declare function buildCursorPrompt(systemPrompt: string, messages: ChatMessage[], context?: ClientContext, attachmentPaths?: string[], priorConversationsContext?: string, technical?: boolean): string;
 /** Conversation + context for Claude (system prompt passed separately). */
-declare function buildClaudeUserPrompt(messages: ChatMessage[], context?: ClientContext, attachmentPaths?: string[], priorConversationsContext?: string): string;
+declare function buildClaudeUserPrompt(messages: ChatMessage[], context?: ClientContext, attachmentPaths?: string[], priorConversationsContext?: string, technical?: boolean): string;
 
 declare function createDefaultSystemPrompt(input: {
     productDescription: string;
@@ -111,6 +113,8 @@ declare function createToolValidator(schemas: ToolSchemaMap): (toolCall: ToolCal
     error: string;
 };
 
+/** Stored on assistant rows while a single in-flight AI turn is running. */
+declare const WORKING_PROVIDER = "working";
 /** Minimal persistence contract (file store, SQL, or Maintainer Pro). */
 interface ChatStoreLike {
     ensureConversation(id: string): Promise<void>;
@@ -133,6 +137,8 @@ interface ChatStoreLike {
         senderType?: "client" | "developer" | "ai" | null;
         senderName?: string | null;
     }>>;
+    /** Remove in-progress working placeholders (at most one per conversation). */
+    clearWorkingMessages?(conversationId: string): Promise<void>;
     /** All conversations under the store (for prior-chat context). */
     listConversations?(): Promise<Array<{
         id: string;
@@ -141,6 +147,7 @@ interface ChatStoreLike {
             role: string;
             content: string;
             createdAt?: string | Date;
+            provider?: string | null;
         }>;
     }>>;
     saveToolEvents?(conversationId: string, events: Array<{
@@ -236,4 +243,39 @@ interface PriorConversationOptions {
  */
 declare function buildPriorConversationsContext(db: ChatStoreLike, options: PriorConversationOptions): Promise<string>;
 
-export { type AiCliProviderId, type AiProvider, type AiResponse, type CallAiOptions, type ChatAttachment, type ChatHandlerOptions, type ChatHandlers, type ChatMessage, type ChatSenderType, type ChatStoreLike, type ChatUser, type ClientContext, type LocalStoredMessage, type MaintainerProStoreOptions, type PriorConversationOptions, type ProviderPreference, type ToolCall, type ToolSchemaMap, buildClaudeUserPrompt, buildConversationPrompt, buildCursorPrompt, buildPriorConversationsContext, callAi, commandExists, createAntigravityProvider, createBuiltinProviders, createChatHandler, createClaudeProvider, createCursorProvider, createDefaultSystemPrompt, createLocalDirectoryStore, createMaintainerProStore, createMaintainerProStoreFromEnv, createToolValidator, formatClientContext, getProviderPreference, parseAiResponse, providerLabel, resolveCliBinary, resolveProvider, saveChatAttachments, toNextRoute };
+type WorkspaceKind = "next" | "vite" | "html" | "empty" | "other";
+interface WorkspaceInspectInput {
+    workspaceDir: string;
+    appName?: string;
+    /** When set, the agent diagnoses and tries to fix this failure. */
+    problem?: string;
+    extraContext?: string;
+}
+interface WorkspaceInspectResult {
+    kind: WorkspaceKind;
+    name: string;
+    summary: string;
+    scripts: {
+        ui?: string;
+        backend?: string;
+        app?: string;
+    };
+    ports: {
+        ui?: number;
+        backend?: number;
+        app?: number;
+    };
+    issues: string[];
+    fixes: string[];
+    ready: boolean;
+    provider: string;
+    rawText: string;
+}
+/**
+ * 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
+ * same provider resolution as chat.
+ */
+declare function inspectAndRepairWorkspace(input: WorkspaceInspectInput): Promise<WorkspaceInspectResult>;
+
+export { type AiCliProviderId, type AiProvider, type AiResponse, type CallAiOptions, type ChatAttachment, type ChatHandlerOptions, type ChatHandlers, type ChatMessage, type ChatSenderType, type ChatStoreLike, type ChatUser, type ClientContext, type LocalStoredMessage, type MaintainerProStoreOptions, type PriorConversationOptions, type ProviderPreference, type ToolCall, type ToolSchemaMap, WORKING_PROVIDER, type WorkspaceInspectInput, type WorkspaceInspectResult, type WorkspaceKind, buildClaudeUserPrompt, buildConversationPrompt, buildCursorPrompt, buildPriorConversationsContext, callAi, commandExists, createAntigravityProvider, createBuiltinProviders, createChatHandler, createClaudeProvider, createCursorProvider, createDefaultSystemPrompt, createLocalDirectoryStore, createMaintainerProStore, createMaintainerProStoreFromEnv, createToolValidator, formatClientContext, getProviderPreference, inspectAndRepairWorkspace, parseAiResponse, providerLabel, resolveCliBinary, resolveProvider, saveChatAttachments, toNextRoute };

package/dist/index.d.ts

@@ -56,6 +56,8 @@ interface CallAiOptions {
     priorConversationsContext?: string;
     /** Extra / override providers (e.g. future HTTP model backends). */
     providers?: AiProvider[];
+    /** When true, skip the end-user chat footer so the agent can return structured output. */
+    technical?: boolean;
 }
 interface AiProvider {
     id: string;
@@ -85,9 +87,9 @@ declare function parseAiResponse(raw: string, provider: AiCliProviderId): AiResp
 declare function buildConversationPrompt(messages: ChatMessage[]): string;
 declare function formatClientContext(context?: ClientContext): string;
 /** Full prompt for providers without a native --system-prompt flag (Cursor). */
-declare function buildCursorPrompt(systemPrompt: string, messages: ChatMessage[], context?: ClientContext, attachmentPaths?: string[], priorConversationsContext?: string): string;
+declare function buildCursorPrompt(systemPrompt: string, messages: ChatMessage[], context?: ClientContext, attachmentPaths?: string[], priorConversationsContext?: string, technical?: boolean): string;
 /** Conversation + context for Claude (system prompt passed separately). */
-declare function buildClaudeUserPrompt(messages: ChatMessage[], context?: ClientContext, attachmentPaths?: string[], priorConversationsContext?: string): string;
+declare function buildClaudeUserPrompt(messages: ChatMessage[], context?: ClientContext, attachmentPaths?: string[], priorConversationsContext?: string, technical?: boolean): string;
 
 declare function createDefaultSystemPrompt(input: {
     productDescription: string;
@@ -111,6 +113,8 @@ declare function createToolValidator(schemas: ToolSchemaMap): (toolCall: ToolCal
     error: string;
 };
 
+/** Stored on assistant rows while a single in-flight AI turn is running. */
+declare const WORKING_PROVIDER = "working";
 /** Minimal persistence contract (file store, SQL, or Maintainer Pro). */
 interface ChatStoreLike {
     ensureConversation(id: string): Promise<void>;
@@ -133,6 +137,8 @@ interface ChatStoreLike {
         senderType?: "client" | "developer" | "ai" | null;
         senderName?: string | null;
     }>>;
+    /** Remove in-progress working placeholders (at most one per conversation). */
+    clearWorkingMessages?(conversationId: string): Promise<void>;
     /** All conversations under the store (for prior-chat context). */
     listConversations?(): Promise<Array<{
         id: string;
@@ -141,6 +147,7 @@ interface ChatStoreLike {
             role: string;
             content: string;
             createdAt?: string | Date;
+            provider?: string | null;
         }>;
     }>>;
     saveToolEvents?(conversationId: string, events: Array<{
@@ -236,4 +243,39 @@ interface PriorConversationOptions {
  */
 declare function buildPriorConversationsContext(db: ChatStoreLike, options: PriorConversationOptions): Promise<string>;
 
-export { type AiCliProviderId, type AiProvider, type AiResponse, type CallAiOptions, type ChatAttachment, type ChatHandlerOptions, type ChatHandlers, type ChatMessage, type ChatSenderType, type ChatStoreLike, type ChatUser, type ClientContext, type LocalStoredMessage, type MaintainerProStoreOptions, type PriorConversationOptions, type ProviderPreference, type ToolCall, type ToolSchemaMap, buildClaudeUserPrompt, buildConversationPrompt, buildCursorPrompt, buildPriorConversationsContext, callAi, commandExists, createAntigravityProvider, createBuiltinProviders, createChatHandler, createClaudeProvider, createCursorProvider, createDefaultSystemPrompt, createLocalDirectoryStore, createMaintainerProStore, createMaintainerProStoreFromEnv, createToolValidator, formatClientContext, getProviderPreference, parseAiResponse, providerLabel, resolveCliBinary, resolveProvider, saveChatAttachments, toNextRoute };
+type WorkspaceKind = "next" | "vite" | "html" | "empty" | "other";
+interface WorkspaceInspectInput {
+    workspaceDir: string;
+    appName?: string;
+    /** When set, the agent diagnoses and tries to fix this failure. */
+    problem?: string;
+    extraContext?: string;
+}
+interface WorkspaceInspectResult {
+    kind: WorkspaceKind;
+    name: string;
+    summary: string;
+    scripts: {
+        ui?: string;
+        backend?: string;
+        app?: string;
+    };
+    ports: {
+        ui?: number;
+        backend?: number;
+        app?: number;
+    };
+    issues: string[];
+    fixes: string[];
+    ready: boolean;
+    provider: string;
+    rawText: string;
+}
+/**
+ * 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
+ * same provider resolution as chat.
+ */
+declare function inspectAndRepairWorkspace(input: WorkspaceInspectInput): Promise<WorkspaceInspectResult>;
+
+export { type AiCliProviderId, type AiProvider, type AiResponse, type CallAiOptions, type ChatAttachment, type ChatHandlerOptions, type ChatHandlers, type ChatMessage, type ChatSenderType, type ChatStoreLike, type ChatUser, type ClientContext, type LocalStoredMessage, type MaintainerProStoreOptions, type PriorConversationOptions, type ProviderPreference, type ToolCall, type ToolSchemaMap, WORKING_PROVIDER, type WorkspaceInspectInput, type WorkspaceInspectResult, type WorkspaceKind, buildClaudeUserPrompt, buildConversationPrompt, buildCursorPrompt, buildPriorConversationsContext, callAi, commandExists, createAntigravityProvider, createBuiltinProviders, createChatHandler, createClaudeProvider, createCursorProvider, createDefaultSystemPrompt, createLocalDirectoryStore, createMaintainerProStore, createMaintainerProStoreFromEnv, createToolValidator, formatClientContext, getProviderPreference, inspectAndRepairWorkspace, parseAiResponse, providerLabel, resolveCliBinary, resolveProvider, saveChatAttachments, toNextRoute };

package/dist/index.js

@@ -43,7 +43,7 @@ function splitMessages(messages) {
   const history = latestUserIndex > 0 ? messages.slice(0, latestUserIndex) : [];
   return { request, history };
 }
-function buildUserFacingPrompt(systemPrompt, messages, context, attachmentPaths, priorConversationsContext) {
+function buildUserFacingPrompt(systemPrompt, messages, context, attachmentPaths, priorConversationsContext, technical) {
   const { request, history } = splitMessages(messages);
   const historyBlock = history.length > 0 ? `Conversation so far:
 ${buildConversationPrompt(history)}
@@ -63,27 +63,30 @@ ${buildConversationPrompt(history)}
 ${attachmentPaths.map((p) => `- ${p}`).join("\n")}
 
 ` : "";
+  const closer = technical ? "Do the work now. Follow the requested output format exactly." : "Do the work now (or ask one short clarifying question if needed). Reply in English, non-technical and user-facing. If it's not resolving, offer a quick call.";
   return `${systemSection}${contextSection}${priorSection}${historyBlock}${attachmentsSection}Current user request:
 ${request || "(See the attached screenshot(s).)"}
 
-Do the work now (or ask one short clarifying question if needed). Reply in English, non-technical and user-facing. If it's not resolving, offer a quick call.`;
+${closer}`;
 }
-function buildCursorPrompt(systemPrompt, messages, context, attachmentPaths, priorConversationsContext) {
+function buildCursorPrompt(systemPrompt, messages, context, attachmentPaths, priorConversationsContext, technical) {
   return buildUserFacingPrompt(
     systemPrompt,
     messages,
     context,
     attachmentPaths,
-    priorConversationsContext
+    priorConversationsContext,
+    technical
   );
 }
-function buildClaudeUserPrompt(messages, context, attachmentPaths, priorConversationsContext) {
+function buildClaudeUserPrompt(messages, context, attachmentPaths, priorConversationsContext, technical) {
   return buildUserFacingPrompt(
     null,
     messages,
     context,
     attachmentPaths,
-    priorConversationsContext
+    priorConversationsContext,
+    technical
   );
 }
 
@@ -196,7 +199,8 @@ async function callClaudeCli(command, messages, context, options) {
     messages,
     context,
     options.attachmentPaths,
-    options.priorConversationsContext
+    options.priorConversationsContext,
+    options.technical
   );
   const resolved = resolveCliCommand("claude", command);
   const workspace = options.workspaceDir ?? process.env.AI_CLI_WORKSPACE ?? process.cwd();
@@ -235,7 +239,8 @@ async function callCursorCli(command, messages, context, options) {
     messages,
     context,
     options.attachmentPaths,
-    options.priorConversationsContext
+    options.priorConversationsContext,
+    options.technical
   );
   const resolved = resolveCliCommand("cursor", command);
   const workspace = options.workspaceDir ?? process.env.AI_CLI_WORKSPACE ?? process.cwd();
@@ -276,7 +281,8 @@ async function callAntigravityCli(command, messages, context, options) {
     messages,
     context,
     options.attachmentPaths,
-    options.priorConversationsContext
+    options.priorConversationsContext,
+    options.technical
   );
   const prompt = `You are operating as a coding agent with full permission to read and edit files in this workspace. Do not introduce yourself. Do not ask what you are. Execute the user's latest request now (edit files and/or emit runtime tool JSON as instructed).
 
@@ -533,7 +539,9 @@ async function buildPriorConversationsContext(db, options) {
   ).slice(0, maxConversations) : ranked;
   const blocks = selected.map((c) => {
     const slice = c.messages.length > maxMessages ? c.messages.slice(-maxMessages) : c.messages;
-    const lines = slice.filter((m) => m.role === "user" || m.role === "assistant").map(
+    const lines = slice.filter(
+      (m) => (m.role === "user" || m.role === "assistant") && m.provider !== "working" && Boolean(m.content?.trim())
+    ).map(
       (m) => `${m.role === "user" ? "Human" : "Assistant"}: ${truncate(m.content)}`
     );
     const when = c.updatedAt ? ` (updated ${c.updatedAt.slice(0, 10)})` : "";
@@ -566,6 +574,18 @@ function createToolValidator(schemas) {
 }
 
 // src/http/handler.ts
+var WORKING_PROVIDER = "working";
+async function setWorkingMessage(db, conversationId) {
+  await db.ensureConversation(conversationId);
+  await db.clearWorkingMessages?.(conversationId);
+  await db.saveMessage({
+    conversationId,
+    role: "assistant",
+    content: "",
+    provider: WORKING_PROVIDER,
+    senderType: "ai"
+  });
+}
 var SHARED_CONVERSATION_ID = "shared";
 var conversationTurnSeq = /* @__PURE__ */ new Map();
 function beginConversationTurn(conversationId) {
@@ -638,6 +658,8 @@ function createChatHandler(options) {
       }
     },
     async POST(request) {
+      let trackedConversationId;
+      let trackedTurn = 0;
       try {
         const body = await request.json();
         const conversationId = await resolveSharedConversationId(
@@ -645,21 +667,16 @@ function createChatHandler(options) {
           options,
           body.conversationId
         );
-        if (body.type === "status") {
-          const content = body.content?.trim();
-          if (!conversationId || !content) {
+        trackedConversationId = conversationId;
+        if (body.type === "working-clear") {
+          if (!conversationId) {
             return Response.json(
-              { error: "conversationId and content are required" },
+              { error: "conversationId is required" },
               { status: 400 }
             );
           }
-          if (options.db) {
-            await options.db.ensureConversation(conversationId);
-            await options.db.saveMessage({
-              conversationId,
-              role: "assistant",
-              content
-            });
+          if (options.db?.clearWorkingMessages) {
+            await options.db.clearWorkingMessages(conversationId);
           }
           return Response.json({ ok: true, conversationId });
         }
@@ -707,7 +724,8 @@ function createChatHandler(options) {
           );
           persistAttachmentPaths = attachmentPaths;
         }
-        const turn = beginConversationTurn(conversationId);
+        const turn = beginConversationTurn(conversationId ?? SHARED_CONVERSATION_ID);
+        trackedTurn = turn;
         const signal = request.signal;
         if (options.db && conversationId) {
           const latest = messages[messages.length - 1];
@@ -723,13 +741,26 @@ function createChatHandler(options) {
               senderName: body.senderName?.trim() || void 0
             });
           }
+          await setWorkingMessage(options.db, conversationId);
         }
         const latestUser = [...messages].reverse().find((m) => m.role === "user");
         const priorConversationsContext = options.db ? await buildPriorConversationsContext(options.db, {
           excludeConversationId: conversationId,
           currentRequest: latestUser?.content ?? ""
         }) : "";
-        if (signal.aborted || !isActiveConversationTurn(conversationId, turn)) {
+        if (!isActiveConversationTurn(
+          conversationId ?? SHARED_CONVERSATION_ID,
+          turn
+        )) {
+          return Response.json({
+            superseded: true,
+            conversationId: conversationId ?? null
+          });
+        }
+        if (signal.aborted) {
+          if (options.db?.clearWorkingMessages && conversationId) {
+            await options.db.clearWorkingMessages(conversationId);
+          }
           return Response.json({
             superseded: true,
             conversationId: conversationId ?? null
@@ -740,7 +771,10 @@ function createChatHandler(options) {
           attachmentPaths,
           priorConversationsContext: priorConversationsContext || void 0
         });
-        if (!isActiveConversationTurn(conversationId, turn)) {
+        if (!isActiveConversationTurn(
+          conversationId ?? SHARED_CONVERSATION_ID,
+          turn
+        )) {
           return Response.json({
             superseded: true,
             conversationId: conversationId ?? null
@@ -752,6 +786,7 @@ function createChatHandler(options) {
         }
         if (options.db && conversationId) {
           await options.db.ensureConversation(conversationId);
+          await options.db.clearWorkingMessages?.(conversationId);
           await options.db.saveMessage({
             conversationId,
             role: "assistant",
@@ -775,6 +810,11 @@ function createChatHandler(options) {
         });
       } catch (err) {
         console.error("Chat API error:", err);
+        if (trackedConversationId && options.db?.clearWorkingMessages && isActiveConversationTurn(trackedConversationId, trackedTurn)) {
+          await options.db.clearWorkingMessages(trackedConversationId).catch(
+            () => void 0
+          );
+        }
         return Response.json(
           {
             error: "Sorry about that \u2014 I couldn't finish this right now. Happy to jump on a quick call if you'd like help \u2014 just let us know when works."
@@ -844,6 +884,16 @@ function createLocalDirectoryStore(baseDir) {
       await writeConversation(filePath, existing);
       return message;
     },
+    async clearWorkingMessages(conversationId) {
+      const filePath = fileFor(conversationId);
+      const existing = await readConversation(filePath);
+      if (!existing) return;
+      const next = existing.messages.filter((m) => m.provider !== "working");
+      if (next.length === existing.messages.length) return;
+      existing.messages = next;
+      existing.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+      await writeConversation(filePath, existing);
+    },
     async listMessages(conversationId) {
       const existing = await readConversation(fileFor(conversationId));
       return existing?.messages ?? [];
@@ -950,6 +1000,15 @@ function createMaintainerProStore(options) {
       );
       return data.message;
     },
+    async clearWorkingMessages(conversationId) {
+      await mpFetch(
+        baseUrl,
+        apiKey,
+        `/api/v1/store/conversations/${encodeURIComponent(conversationId)}/messages?provider=working`,
+        { method: "DELETE" },
+        fetchImpl
+      );
+    },
     async listMessages(conversationId) {
       const data = await mpFetch(
         baseUrl,
@@ -1029,7 +1088,114 @@ function createMaintainerProStoreFromEnv() {
   if (!baseUrl || !apiKey) return null;
   return createMaintainerProStore({ baseUrl, apiKey });
 }
+
+// src/workspace-inspect.ts
+import { z } from "zod";
+var inspectJsonSchema = z.object({
+  kind: z.enum(["next", "vite", "html", "empty", "other"]).optional(),
+  name: z.string().max(200).optional(),
+  summary: z.string().max(800).optional(),
+  scripts: z.object({
+    ui: z.string().min(1).max(64).optional(),
+    backend: z.string().min(1).max(64).optional(),
+    app: z.string().min(1).max(64).optional()
+  }).optional(),
+  ports: z.object({
+    ui: z.number().int().min(1).max(65535).optional(),
+    backend: z.number().int().min(1).max(65535).optional(),
+    app: z.number().int().min(1).max(65535).optional()
+  }).optional(),
+  issues: z.array(z.string().max(500)).max(20).optional(),
+  fixes: z.array(z.string().max(500)).max(20).optional(),
+  ready: z.boolean().optional()
+});
+function extractInspectJson(text) {
+  const fence = text.match(/```json\s*([\s\S]*?)```/i);
+  const raw = fence?.[1]?.trim() || text.match(/\{[\s\S]*\}/)?.[0];
+  if (!raw) return null;
+  try {
+    const parsed = inspectJsonSchema.safeParse(JSON.parse(raw));
+    return parsed.success ? parsed.data : null;
+  } catch {
+    return null;
+  }
+}
+function setupSystemPrompt(input) {
+  return `You are Maintainer Pro's local setup assistant on the developer's machine.
+
+Workspace: ${input.workspaceDir}
+App name: ${input.appName || "the app"}
+
+Inspect this repository (package.json, README, lockfiles, existing env files, how the UI and API start).
+You MAY edit files to fix setup problems that would block local run or the chat widget (env keys, widget mount, missing config).
+Do NOT start long-lived dev servers, tunnels, or install global tools.
+Do NOT run \`npm run dev\` or similar.
+
+Script names you report MUST already exist in package.json. Omit chat/ai-server scripts.
+
+End with a short human summary AND one \`\`\`json fence with:
+
+{
+  "kind": "next" | "vite" | "html" | "empty" | "other",
+  "name": "package or folder name",
+  "summary": "one sentence about this project",
+  "scripts": { "ui": "dev:client", "backend": "dev:server" },
+  "ports": { "ui": 5173, "backend": 4100 },
+  "issues": ["remaining problems"],
+  "fixes": ["what you changed"],
+  "ready": true
+}`;
+}
+function setupUserMessage(input) {
+  if (input.problem?.trim()) {
+    return `The local bridge failed to keep this project running:
+
+${input.problem.trim()}
+
+${input.extraContext ? `${input.extraContext.trim()}
+
+` : ""}Inspect the repo, fix the cause if you can, and return the JSON report.`;
+  }
+  return `${input.extraContext ? `${input.extraContext.trim()}
+
+` : ""}Inspect this project, fix any setup gaps you can, and return the JSON report.`;
+}
+async function inspectAndRepairWorkspace(input) {
+  const workspaceDir = input.workspaceDir;
+  const provider = await resolveProvider({ preference: "auto" });
+  const response = await callAi(
+    [{ role: "user", content: setupUserMessage(input) }],
+    {
+      route: "/local-setup",
+      pageTitle: input.appName || "Local setup",
+      relevantFiles: ["package.json", "README.md", ".env", ".env.example"],
+      data: {
+        workspaceDir,
+        problem: input.problem || null
+      }
+    },
+    {
+      systemPrompt: setupSystemPrompt(input),
+      workspaceDir,
+      technical: true
+    }
+  );
+  const parsed = extractInspectJson(response.text);
+  return {
+    kind: parsed?.kind ?? "other",
+    name: parsed?.name?.trim() || input.appName || "",
+    summary: parsed?.summary?.trim() || response.text.replace(/```json[\s\S]*```/i, "").trim().slice(0, 400),
+    scripts: parsed?.scripts ?? {},
+    ports: parsed?.ports ?? {},
+    issues: parsed?.issues ?? [],
+    fixes: parsed?.fixes ?? [],
+    ready: parsed?.ready ?? parsed?.issues?.length === 0,
+    provider: response.provider || provider.id,
+    rawText: response.text
+  };
+}
 export {
+  WORKING_PROVIDER,
   buildClaudeUserPrompt,
   buildConversationPrompt,
   buildCursorPrompt,
@@ -1048,6 +1214,7 @@ export {
   createToolValidator,
   formatClientContext,
   getProviderPreference,
+  inspectAndRepairWorkspace,
   parseAiResponse,
   providerLabel,
   resolveCliBinary,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maintainer-pro/ai-cli",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Maintainer Pro server SDK: Claude/Cursor CLI, chat HTTP handlers, and optional SQL persistence",
   "keywords": [
     "maintainer-pro",