@mcoda/integrations 0.1.9 → 0.1.11

package/README.md

@@ -27,7 +27,7 @@ const docs = await client.search({ docType: "rfp", query: "payments" });
 
 ## Notes
 - Docdex state lives under `~/.docdex` (managed by the `docdex` CLI); mcoda does not create repo-local `.docdex`.
-- Chromium QA expects Playwright browsers provisioned via `docdex setup`.
+- Chromium QA expects Docdex-installed Chromium (`docdex setup` or `MCODA_QA_CHROMIUM_PATH`).
 - Some integrations call external services; configure base URLs and tokens as needed.
 - Primarily used by the mcoda CLI; APIs may evolve.
 

package/dist/docdex/DocdexClient.d.ts

@@ -28,14 +28,21 @@ export declare class DocdexClient {
     private resolvedBaseUrl?;
     private repoId?;
     private initializing;
+    private disabledReason?;
     constructor(options?: {
         workspaceRoot?: string;
         baseUrl?: string;
         authToken?: string;
         repoId?: string;
     });
+    disable(reason?: string): void;
+    isAvailable(): boolean;
     private normalizePath;
+    private resolveLocalDocPath;
+    private loadLocalDoc;
     private resolveBaseUrl;
+    private buildMissingRepoMessage;
+    ensureRepoScope(): Promise<void>;
     private ensureRepoInitialized;
     private fetchRemote;
     private buildLocalDoc;
@@ -51,5 +58,8 @@ export declare class DocdexClient {
     reindex(): Promise<void>;
     registerDocument(input: RegisterDocumentInput): Promise<DocdexDocument>;
     ensureRegisteredFromFile(docPath: string, docType: string, metadata?: Record<string, unknown>): Promise<DocdexDocument>;
+    private callMcp;
+    memorySave(text: string): Promise<void>;
+    savePreference(agentId: string, category: string, content: string): Promise<void>;
 }
 //# sourceMappingURL=DocdexClient.d.ts.map

package/dist/docdex/DocdexClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DocdexClient.d.ts","sourceRoot":"","sources":["../../src/docdex/DocdexClient.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAkDD,qBAAa,YAAY;IAMrB,OAAO,CAAC,OAAO;IALjB,OAAO,CAAC,eAAe,CAAC,CAAS;IACjC,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,YAAY,CAAS;gBAGnB,OAAO,GAAE;QACf,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACZ;IAKR,OAAO,CAAC,aAAa;YAYP,cAAc;YAWd,qBAAqB;YA0BrB,WAAW;IA8BzB,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,mBAAmB;IAmDrB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IA4BtD,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAS1F,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAkBtH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAcxB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC;IA0BvE,wBAAwB,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,cAAc,CAAC;CAoB3B"}
+{"version":3,"file":"DocdexClient.d.ts","sourceRoot":"","sources":["../../src/docdex/DocdexClient.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAkDD,qBAAa,YAAY;IAOrB,OAAO,CAAC,OAAO;IANjB,OAAO,CAAC,eAAe,CAAC,CAAS;IACjC,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,cAAc,CAAC,CAAS;gBAGtB,OAAO,GAAE;QACf,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;KACZ;IAKR,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAI9B,WAAW,IAAI,OAAO;IAItB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,mBAAmB;YASb,YAAY;YAYZ,cAAc;IAY5B,OAAO,CAAC,uBAAuB;IAKzB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;YAWxB,qBAAqB;YA0BrB,WAAW;IAwCzB,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,mBAAmB;IAmDrB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IA4BtD,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAkB1F,MAAM,CAAC,MAAM,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAkBtH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAcxB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC;IA0BvE,wBAAwB,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,cAAc,CAAC;YAqBZ,OAAO;IAyBf,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQvC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAQxF"}

package/dist/docdex/DocdexClient.js

@@ -59,6 +59,12 @@ export class DocdexClient {
         this.initializing = false;
         this.repoId = options.repoId;
     }
+    disable(reason) {
+        this.disabledReason = reason?.trim() || "docdex unavailable";
+    }
+    isAvailable() {
+        return !this.disabledReason;
+    }
     normalizePath(inputPath) {
         if (!inputPath)
             return undefined;
@@ -71,7 +77,32 @@ export class DocdexClient {
         }
         return absolute;
     }
+    resolveLocalDocPath(docPath) {
+        if (!this.options.workspaceRoot)
+            return undefined;
+        const root = path.resolve(this.options.workspaceRoot);
+        const absolute = path.resolve(path.isAbsolute(docPath) ? docPath : path.join(root, docPath));
+        if (!absolute.startsWith(root))
+            return undefined;
+        const relative = path.relative(root, absolute);
+        return { absolute, relative: relative || undefined };
+    }
+    async loadLocalDoc(docPath, docType) {
+        const resolved = this.resolveLocalDocPath(docPath);
+        if (!resolved)
+            return undefined;
+        try {
+            const content = await fs.readFile(resolved.absolute, "utf8");
+            const inferred = docType || inferDocType(resolved.relative ?? docPath);
+            return this.buildLocalDoc(inferred, resolved.relative ?? docPath, content);
+        }
+        catch {
+            return undefined;
+        }
+    }
     async resolveBaseUrl() {
+        if (this.disabledReason)
+            return undefined;
         if (this.options.baseUrl !== undefined) {
             const trimmed = this.options.baseUrl.trim();
             return trimmed ? normalizeBaseUrl(trimmed) : undefined;
@@ -82,6 +113,21 @@ export class DocdexClient {
         this.resolvedBaseUrl = resolved ? normalizeBaseUrl(resolved) : undefined;
         return this.resolvedBaseUrl;
     }
+    buildMissingRepoMessage() {
+        const root = this.options.workspaceRoot ? path.resolve(this.options.workspaceRoot) : "unknown workspace";
+        return `Docdex repo scope missing for ${root}. Ensure docdexd is running and initialized for this repo, or set MCODA_DOCDEX_URL and MCODA_DOCDEX_REPO_ID.`;
+    }
+    async ensureRepoScope() {
+        const baseUrl = await this.resolveBaseUrl();
+        if (!baseUrl)
+            return;
+        if (!this.repoId) {
+            await this.ensureRepoInitialized(baseUrl, true);
+        }
+        if (!this.repoId) {
+            throw new Error(this.buildMissingRepoMessage());
+        }
+    }
     async ensureRepoInitialized(baseUrl, force = false) {
         if ((this.repoId && !force) || this.initializing)
             return;
@@ -113,18 +159,29 @@ export class DocdexClient {
         }
     }
     async fetchRemote(pathname, init) {
+        if (this.disabledReason) {
+            throw new Error(`Docdex unavailable: ${this.disabledReason}`);
+        }
         const baseUrl = await this.resolveBaseUrl();
         if (!baseUrl) {
             throw new Error("Docdex baseUrl not configured. Run docdex setup or set MCODA_DOCDEX_URL.");
         }
-        await this.ensureRepoInitialized(baseUrl);
+        await this.ensureRepoScope();
         const url = new URL(pathname, baseUrl);
+        if (this.repoId && !url.searchParams.has("repo_id")) {
+            url.searchParams.set("repo_id", this.repoId);
+        }
+        if (this.options.workspaceRoot && !url.searchParams.has("repo_root")) {
+            url.searchParams.set("repo_root", path.resolve(this.options.workspaceRoot));
+        }
         const buildHeaders = () => {
             const headers = { "Content-Type": "application/json" };
             if (this.options.authToken)
                 headers.authorization = `Bearer ${this.options.authToken}`;
             if (this.repoId)
                 headers["x-docdex-repo-id"] = this.repoId;
+            if (this.options.workspaceRoot)
+                headers["x-docdex-repo-root"] = path.resolve(this.options.workspaceRoot);
             return { ...headers, ...init?.headers };
         };
         const response = await fetch(url, { ...init, headers: buildHeaders() });
@@ -241,9 +298,19 @@ export class DocdexClient {
     async findDocumentByPath(docPath, docType) {
         const normalized = this.normalizePath(docPath);
         const query = normalized ?? docPath;
-        const docs = await this.search({ query, docType });
-        if (!docs.length)
-            return undefined;
+        let docs = [];
+        try {
+            docs = await this.search({ query, docType });
+        }
+        catch (error) {
+            const local = await this.loadLocalDoc(docPath, docType);
+            if (local)
+                return local;
+            throw error;
+        }
+        if (!docs.length) {
+            return await this.loadLocalDoc(docPath, docType);
+        }
         if (!normalized)
             return docs[0];
         return docs.find((doc) => doc.path === normalized) ?? docs[0];
@@ -331,4 +398,45 @@ export class DocdexClient {
             return this.buildLocalDoc(inferredType, normalizedPath, content, metadata);
         }
     }
+    async callMcp(toolName, args) {
+        const payload = {
+            jsonrpc: "2.0",
+            id: randomUUID(),
+            method: "tools/call",
+            params: {
+                name: toolName,
+                arguments: args,
+            },
+        };
+        const response = await this.fetchRemote("/v1/mcp", {
+            method: "POST",
+            body: JSON.stringify(payload),
+        });
+        const raw = (await response.json());
+        if (raw.error) {
+            throw new Error(raw.error.message ?? "Docdex MCP call failed");
+        }
+        const result = raw.result;
+        if (result && typeof result === "object" && result.structuredContent !== undefined) {
+            return result.structuredContent;
+        }
+        return result;
+    }
+    async memorySave(text) {
+        if (!text.trim())
+            return;
+        await this.callMcp("docdex_memory_save", {
+            project_root: this.options.workspaceRoot,
+            text,
+        });
+    }
+    async savePreference(agentId, category, content) {
+        if (!agentId.trim() || !category.trim() || !content.trim())
+            return;
+        await this.callMcp("docdex_save_preference", {
+            agent_id: agentId,
+            category,
+            content,
+        });
+    }
 }

package/dist/docdex/DocdexRuntime.d.ts

@@ -8,18 +8,32 @@ export interface DocdexCheckResult {
         details?: Record<string, unknown>;
     }>;
 }
-export interface DocdexBrowserInfo {
+export interface DocdexHealthSummary {
     ok: boolean;
     message?: string;
-    browsersPath?: string;
-    browsers?: Array<{
+    failedChecks?: Array<{
         name?: string;
-        path?: string;
-        version?: string;
+        status?: string;
+        message?: string;
     }>;
 }
+export interface DocdexChromiumDetails {
+    path?: string;
+    manifestPath?: string;
+    installedAt?: string;
+    version?: string;
+    platform?: string;
+    downloadUrl?: string;
+}
+export interface DocdexBrowserInfo {
+    ok: boolean;
+    message?: string;
+    installHint?: string;
+    autoInstallEnabled?: boolean;
+    configuredKind?: string;
+    chromium?: DocdexChromiumDetails;
+}
 export declare const resolveDocdexBinary: () => string | undefined;
-export declare const resolvePlaywrightCli: () => string | undefined;
 export declare const runDocdex: (args: string[], options?: {
     cwd?: string;
     env?: NodeJS.ProcessEnv;
@@ -27,14 +41,17 @@ export declare const runDocdex: (args: string[], options?: {
     stdout: string;
     stderr: string;
 }>;
+export declare const parseDocdexCheckOutput: (output: string) => DocdexCheckResult;
 export declare const readDocdexCheck: (options?: {
     cwd?: string;
     env?: NodeJS.ProcessEnv;
 }) => Promise<DocdexCheckResult>;
+export declare const summarizeDocdexCheck: (check: DocdexCheckResult) => DocdexHealthSummary;
 export declare const resolveDocdexBaseUrl: (options?: {
     cwd?: string;
     env?: NodeJS.ProcessEnv;
 }) => Promise<string | undefined>;
+export declare const parseDocdexBrowserCheck: (check: DocdexCheckResult) => DocdexBrowserInfo;
 export declare const resolveDocdexBrowserInfo: (options?: {
     cwd?: string;
     env?: NodeJS.ProcessEnv;

package/dist/docdex/DocdexRuntime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DocdexRuntime.d.ts","sourceRoot":"","sources":["../../src/docdex/DocdexRuntime.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,KAAK,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtE;AAuBD,eAAO,MAAM,mBAAmB,QAAO,MAAM,GAAG,SAI/C,CAAC;AAEF,eAAO,MAAM,oBAAoB,QAAO,MAAM,GAAG,SAehD,CAAC;AAEF,eAAO,MAAM,SAAS,GACpB,MAAM,MAAM,EAAE,EACd,UAAS;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAO,KACtD,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAU5C,CAAC;AAEF,eAAO,MAAM,eAAe,GAAU,UAAS;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAO,KAAG,OAAO,CAAC,iBAAiB,CAsBxH,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAU,UAAS;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAO,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAsB9H,CAAC;AAEF,eAAO,MAAM,wBAAwB,GACnC,UAAS;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAO,KACtD,OAAO,CAAC,iBAAiB,CAgC3B,CAAC"}
+{"version":3,"file":"DocdexRuntime.d.ts","sourceRoot":"","sources":["../../src/docdex/DocdexRuntime.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,KAAK,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5E;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAClC;AAuBD,eAAO,MAAM,mBAAmB,QAAO,MAAM,GAAG,SAI/C,CAAC;AAEF,eAAO,MAAM,SAAS,GACpB,MAAM,MAAM,EAAE,EACd,UAAS;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAO,KACtD,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAU5C,CAAC;AAUF,eAAO,MAAM,sBAAsB,GAAI,QAAQ,MAAM,KAAG,iBAiCvD,CAAC;AAEF,eAAO,MAAM,eAAe,GAAU,UAAS;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAO,KAAG,OAAO,CAAC,iBAAiB,CAexH,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,OAAO,iBAAiB,KAAG,mBAsB/D,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAU,UAAS;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAO,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAsB9H,CAAC;AA0BF,eAAO,MAAM,uBAAuB,GAAI,OAAO,iBAAiB,KAAG,iBAoClE,CAAC;AAEF,eAAO,MAAM,wBAAwB,GACnC,UAAS;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAO,KACtD,OAAO,CAAC,iBAAiB,CAW3B,CAAC"}

package/dist/docdex/DocdexRuntime.js

@@ -29,25 +29,6 @@ export const resolveDocdexBinary = () => {
         return undefined;
     return path.join(root, "bin", "docdex.js");
 };
-export const resolvePlaywrightCli = () => {
-    const require = createRequire(import.meta.url);
-    try {
-        return require.resolve("playwright/cli.js");
-    }
-    catch {
-        // fall through to docdex-local resolution
-    }
-    const root = resolveDocdexPackageRoot();
-    if (!root)
-        return undefined;
-    try {
-        const requireFromDocdex = createRequire(path.join(root, "package.json"));
-        return requireFromDocdex.resolve("playwright/cli.js");
-    }
-    catch {
-        return undefined;
-    }
-};
 export const runDocdex = async (args, options = {}) => {
     const binary = resolveDocdexBinary();
     if (!binary) {
@@ -59,6 +40,46 @@ export const runDocdex = async (args, options = {}) => {
     });
     return { stdout: stdout ?? "", stderr: stderr ?? "" };
 };
+const MAX_DOCDEX_SNIPPET = 240;
+const formatDocdexSnippet = (value) => {
+    const trimmed = value.trim().replace(/\s+/g, " ");
+    if (trimmed.length <= MAX_DOCDEX_SNIPPET)
+        return trimmed;
+    return `${trimmed.slice(0, MAX_DOCDEX_SNIPPET)}...`;
+};
+export const parseDocdexCheckOutput = (output) => {
+    const trimmed = output.trim();
+    if (!trimmed) {
+        throw new Error("Docdex check returned empty output");
+    }
+    const attempts = [{ label: "full", candidate: trimmed }];
+    const braceStart = trimmed.indexOf("{");
+    const braceEnd = trimmed.lastIndexOf("}");
+    if (braceStart !== -1 && braceEnd > braceStart) {
+        attempts.push({ label: "brace-slice", candidate: trimmed.slice(braceStart, braceEnd + 1) });
+    }
+    const lines = trimmed.split(/\r?\n/);
+    for (let i = 0; i < lines.length; i += 1) {
+        const line = lines[i].trim();
+        if (!line.startsWith("{"))
+            continue;
+        const joined = lines.slice(i).join("\n").trim();
+        attempts.push({ label: "line-join", candidate: joined });
+        break;
+    }
+    let lastError;
+    for (const attempt of attempts) {
+        try {
+            return JSON.parse(attempt.candidate);
+        }
+        catch (error) {
+            lastError = error;
+        }
+    }
+    const snippet = formatDocdexSnippet(trimmed);
+    const message = lastError?.message ? `${lastError.message}. ` : "";
+    throw new Error(`Docdex check returned invalid JSON: ${message}Output: "${snippet}"`);
+};
 export const readDocdexCheck = async (options = {}) => {
     let stdout = "";
     let stderr = "";
@@ -74,15 +95,29 @@ export const readDocdexCheck = async (options = {}) => {
         }
     }
     const trimmed = stdout.trim() || stderr.trim();
-    if (!trimmed) {
-        throw new Error("Docdex check returned empty output");
-    }
-    try {
-        return JSON.parse(trimmed);
-    }
-    catch (error) {
-        throw new Error(`Docdex check returned invalid JSON: ${error.message}`);
+    return parseDocdexCheckOutput(trimmed);
+};
+export const summarizeDocdexCheck = (check) => {
+    const failures = check.checks?.filter((item) => item?.status && item.status !== "ok")?.map((item) => ({
+        name: item.name,
+        status: item.status,
+        message: item.message,
+    })) ?? [];
+    if (check.success === false || failures.length > 0) {
+        const details = failures
+            .map((item) => {
+            const head = item.name ? `${item.name}=${item.status ?? "error"}` : item.status ?? "error";
+            const tail = item.message ? ` (${item.message})` : "";
+            return `${head}${tail}`;
+        })
+            .join("; ");
+        return {
+            ok: false,
+            message: details || "Docdex check failed.",
+            failedChecks: failures,
+        };
     }
+    return { ok: true };
 };
 export const resolveDocdexBaseUrl = async (options = {}) => {
     for (const key of DOCDEX_ENV_URLS) {
@@ -109,34 +144,73 @@ export const resolveDocdexBaseUrl = async (options = {}) => {
         return undefined;
     }
 };
+const coerceString = (value) => {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed ? trimmed : undefined;
+};
+const coerceChromiumDetails = (value) => {
+    if (!value || typeof value !== "object")
+        return undefined;
+    const details = value;
+    return {
+        path: coerceString(details.path),
+        manifestPath: coerceString(details.manifest_path ?? details.manifestPath),
+        installedAt: coerceString(details.installed_at ?? details.installedAt),
+        version: coerceString(details.version),
+        platform: coerceString(details.platform),
+        downloadUrl: coerceString(details.download_url ?? details.downloadUrl),
+    };
+};
+const buildBrowserSetupHint = (installHint) => {
+    const hint = installHint ?? "docdexd browser install";
+    return `Run \`${hint}\` to install the headless Chromium browser.`;
+};
+export const parseDocdexBrowserCheck = (check) => {
+    const browserCheck = check.checks?.find((c) => c.name === "browser");
+    const details = browserCheck?.details;
+    const chromium = coerceChromiumDetails(details?.chromium);
+    const installHint = coerceString(details?.install_hint);
+    const autoInstallEnabled = typeof details?.auto_install_enabled === "boolean" ? details.auto_install_enabled : undefined;
+    const configuredKind = coerceString(details?.configured_kind);
+    if (!browserCheck) {
+        const setupHint = buildBrowserSetupHint(installHint);
+        return {
+            ok: false,
+            message: `Docdex browser check unavailable. ${setupHint}`,
+            chromium,
+            installHint,
+            autoInstallEnabled,
+            configuredKind,
+        };
+    }
+    if (browserCheck.status !== "ok") {
+        const setupHint = buildBrowserSetupHint(installHint);
+        return {
+            ok: false,
+            message: `${browserCheck.message ?? "Docdex browser check failed."} ${setupHint}`,
+            chromium,
+            installHint,
+            autoInstallEnabled,
+            configuredKind,
+        };
+    }
+    return {
+        ok: true,
+        chromium,
+        installHint,
+        autoInstallEnabled,
+        configuredKind,
+    };
+};
 export const resolveDocdexBrowserInfo = async (options = {}) => {
-    const setupHint = "Run `docdex setup` to install Playwright and at least one browser.";
     try {
         const check = await readDocdexCheck(options);
-        const browserCheck = check.checks?.find((c) => c.name === "browser");
-        if (!browserCheck || browserCheck.status !== "ok") {
-            return {
-                ok: false,
-                message: `${browserCheck?.message ?? "Docdex browser check failed."} ${setupHint}`,
-            };
-        }
-        const details = browserCheck.details ?? {};
-        const playwright = details.playwright ?? {};
-        const browsers = Array.isArray(playwright.browsers) ? playwright.browsers : [];
-        if (!browsers.length) {
-            return {
-                ok: false,
-                message: `Docdex has no Playwright browsers configured. ${setupHint}`,
-            };
-        }
-        const browsersPath = typeof playwright.browsers_path === "string" ? playwright.browsers_path : undefined;
-        return {
-            ok: true,
-            browsersPath,
-            browsers,
-        };
+        return parseDocdexBrowserCheck(check);
     }
     catch (error) {
+        const setupHint = buildBrowserSetupHint();
         return {
             ok: false,
             message: `Docdex check failed: ${error.message}. ${setupHint}`,

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./docdex/DocdexClient.js";
+export * from "./docdex/DocdexRuntime.js";
 export * from "./telemetry/TelemetryClient.js";
 export * from "./vcs/VcsClient.js";
 export * from "./qa/index.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export * from "./docdex/DocdexClient.js";
+export * from "./docdex/DocdexRuntime.js";
 export * from "./telemetry/TelemetryClient.js";
 export * from "./vcs/VcsClient.js";
 export * from "./qa/index.js";

package/dist/qa/ChromiumQaAdapter.d.ts

@@ -1,10 +1,68 @@
 import { QaProfile } from '@mcoda/shared/qa/QaProfile.js';
+import type { QaBrowserAction } from '@mcoda/shared/qa/QaPlan.js';
 import { QaAdapter } from './QaAdapter.js';
 import { QaContext, QaEnsureResult, QaRunResult } from './QaTypes.js';
+type BrowserFetchResult = {
+    html: string;
+    innerText?: string;
+    textContent?: string;
+    status?: number;
+    finalUrl?: string;
+};
+type BrowserActionResult = {
+    index: number;
+    type: QaBrowserAction['type'];
+    ok: boolean;
+    message?: string;
+    url?: string;
+    durationMs?: number;
+};
+type BrowserActionSnapshot = {
+    index: number;
+    name: string;
+    html: string;
+    innerText?: string;
+    textContent?: string;
+    url?: string;
+};
+export declare const resolveChromiumBinary: () => Promise<string | undefined>;
+declare class NetworkIdleTracker {
+    inflight: number;
+    lastActivity: number;
+    sawLoad: boolean;
+    documentStatus?: number;
+    documentUrl?: string;
+    handle(method: string, params?: any): void;
+}
+declare class CdpClient {
+    private ws;
+    private queue;
+    private nextId;
+    private closed;
+    static connect(wsUrl: string): Promise<CdpClient>;
+    private constructor();
+    call(method: string, params: Record<string, unknown>, tracker?: NetworkIdleTracker, timeoutMs?: number): Promise<any>;
+    waitForNetworkIdle(tracker: NetworkIdleTracker, timeoutMs: number): Promise<boolean>;
+    close(): void;
+}
 export declare class ChromiumQaAdapter implements QaAdapter {
-    private resolveCwd;
     ensureInstalled(profile: QaProfile, ctx: QaContext): Promise<QaEnsureResult>;
     private persistLogs;
+    private persistBrowserArtifacts;
     invoke(profile: QaProfile, ctx: QaContext): Promise<QaRunResult>;
+    private runBrowserActions;
+    private runBrowser;
 }
+export declare const __testing: {
+    resolveActionUrl: (actionUrl: string | undefined, baseUrl: string | undefined) => string | undefined;
+    resolveActionTimeoutMs: (action: QaBrowserAction, fallbackMs: number) => number;
+    runBrowserActionsWithClient: (client: CdpClient, actions: QaBrowserAction[], baseUrl: string | undefined, timeoutMs: number) => Promise<{
+        outcome: "pass" | "fail";
+        errorMessage?: string;
+        results: BrowserActionResult[];
+        snapshots: BrowserActionSnapshot[];
+        finalDom?: BrowserFetchResult;
+    }>;
+};
+export {};
 //# sourceMappingURL=ChromiumQaAdapter.d.ts.map

package/dist/qa/ChromiumQaAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChromiumQaAdapter.d.ts","sourceRoot":"","sources":["../../src/qa/ChromiumQaAdapter.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAQtE,qBAAa,iBAAkB,YAAW,SAAS;IACjD,OAAO,CAAC,UAAU;IASZ,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,cAAc,CAAC;YAqBpE,WAAW;IAYnB,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;CA8CvE"}
+{"version":3,"file":"ChromiumQaAdapter.d.ts","sourceRoot":"","sources":["../../src/qa/ChromiumQaAdapter.ts"],"names":[],"mappings":"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"}