@doksi/mcp 0.1.1

package/README.md

@@ -0,0 +1,11 @@
+# Doksi MCP
+
+MCP server for using Doksi from Claude, Codex, and other MCP clients.
+
+```bash
+npm install
+npm run build
+DOKSI_API_KEY=dk_live_... doksi
+```
+
+The server exposes workspace resources, PRD/user-story prompts, and tools for creating tests, uploading artifacts, and running tests using Doksi.

package/SKILL.md

@@ -0,0 +1,15 @@
+# Doksi MCP
+
+Use Doksi MCP to inspect a Doksi workspace, create tests from product requirements, upload target apps and parameter files, and run tests.
+
+Preferred workflow:
+
+1. Read `doksi://workspace/summary` or call `search_workspace`.
+2. Reuse existing target, category, account, and artifact file IDs when possible.
+3. Create tests with `create_tests`.
+4. Run tests with `run_tests`.
+5. Poll with `get_run`, then inspect failures with `get_result`.
+
+Tool responses are natural language by default. Pass `rawJson: true` only when exact structured data is needed.
+
+Never ask Doksi MCP to reveal account secrets. Account outputs are redacted.

package/dist/api-client.d.ts

@@ -0,0 +1,34 @@
+import type { AddTargetInput, RunTestsInput, SearchWorkspaceInput, TestDefinition, WorkspaceItemInput } from "./types.js";
+export declare class DoksiApiClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly cache;
+    private readonly cacheTtlMs;
+    constructor(baseUrl: string, apiKey: string);
+    invalidateCache(): void;
+    private request;
+    private putToUploadUrl;
+    searchWorkspace(input: SearchWorkspaceInput): Promise<unknown>;
+    getWorkspaceItem(input: WorkspaceItemInput): Promise<unknown>;
+    addAccount(input: {
+        name: string;
+        fieldValues: Record<string, string>;
+        usageContext?: string;
+    }): Promise<unknown>;
+    addCategory(input: {
+        name: string;
+        color?: string;
+    }): Promise<unknown>;
+    addTarget(input: AddTargetInput): Promise<unknown>;
+    uploadArtifactFile(input: {
+        filePath: string;
+        name?: string;
+        mimeType?: string;
+    }): Promise<unknown>;
+    createTests(tests: TestDefinition[]): Promise<unknown>;
+    updateTests(tests: TestDefinition[]): Promise<unknown>;
+    runTests(input: RunTestsInput): Promise<unknown>;
+    getRun(runId: string): Promise<unknown>;
+    getResult(resultId: string): Promise<unknown>;
+    stopRun(runId: string): Promise<unknown>;
+}

package/dist/api-client.js

@@ -0,0 +1,189 @@
+import { readFile, stat } from "fs/promises";
+import { basename, extname } from "path";
+import JSZip from "jszip";
+import { DoksiApiError } from "./types.js";
+export class DoksiApiClient {
+    baseUrl;
+    apiKey;
+    cache = new Map();
+    cacheTtlMs = 30_000;
+    constructor(baseUrl, apiKey) {
+        this.baseUrl = `${baseUrl.replace(/\/+$/, "")}/external/doksi-mcp`;
+        this.apiKey = apiKey;
+    }
+    invalidateCache() {
+        this.cache.clear();
+    }
+    async request(method, path, body, options = {}) {
+        const cacheKey = `${method} ${path} ${JSON.stringify(body ?? null)}`;
+        if (options.cache) {
+            const hit = this.cache.get(cacheKey);
+            if (hit && hit.expiresAt > Date.now())
+                return hit.value;
+        }
+        const response = await fetch(`${this.baseUrl}${path}`, {
+            method,
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                "Content-Type": "application/json",
+            },
+            ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
+        });
+        if (!response.ok) {
+            throw new DoksiApiError(response.status, await response.text(), `${this.baseUrl}${path}`);
+        }
+        const value = (await response.json());
+        if (options.cache) {
+            this.cache.set(cacheKey, { value, expiresAt: Date.now() + this.cacheTtlMs });
+        }
+        return value;
+    }
+    async putToUploadUrl(uploadUrl, bytes, contentType) {
+        const response = await fetch(uploadUrl, {
+            method: "PUT",
+            headers: { "Content-Type": contentType },
+            body: bytes,
+        });
+        if (!response.ok) {
+            throw new Error(`Upload failed with HTTP ${response.status}.`);
+        }
+    }
+    async searchWorkspace(input) {
+        const params = new URLSearchParams();
+        if (input.search)
+            params.set("search", input.search);
+        if (input.limit)
+            params.set("limit", String(input.limit));
+        if (input.skip)
+            params.set("skip", String(input.skip));
+        if (input.kinds?.length)
+            params.set("kinds", input.kinds.join(","));
+        const suffix = params.toString() ? `?${params.toString()}` : "";
+        return this.request("GET", `/workspace${suffix}`, undefined, { cache: true });
+    }
+    async getWorkspaceItem(input) {
+        return this.request("GET", `/items/${encodeURIComponent(input.kind)}/${encodeURIComponent(input.id)}`, undefined, { cache: true });
+    }
+    async addAccount(input) {
+        const result = await this.request("POST", "/accounts", input);
+        this.invalidateCache();
+        return result;
+    }
+    async addCategory(input) {
+        const result = await this.request("POST", "/categories", input);
+        this.invalidateCache();
+        return result;
+    }
+    async addTarget(input) {
+        if (input.filePath) {
+            const name = input.name ?? basename(input.filePath).replace(/\.(apk|zip)$/i, "");
+            const prepared = await prepareAndroidUpload(input.filePath);
+            const upload = await this.request("POST", "/targets/upload-url", {
+                name,
+                category: "android",
+                type: input.platformType,
+            });
+            await this.putToUploadUrl(upload.uploadUrl, prepared.bytes, "application/zip");
+            const result = await this.request("POST", "/targets", {
+                name,
+                fileKey: upload.fileKey,
+                category: "android",
+                type: input.platformType,
+            });
+            this.invalidateCache();
+            return result;
+        }
+        if (input.url) {
+            const result = await this.request("POST", "/targets", {
+                name: input.name ?? input.url,
+                url: input.url,
+                category: input.category ?? "web",
+                type: input.platformType,
+            });
+            this.invalidateCache();
+            return result;
+        }
+        throw new Error("Provide either filePath for Android upload or url for a web target.");
+    }
+    async uploadArtifactFile(input) {
+        const fileName = input.name ?? basename(input.filePath);
+        const sizeBytes = (await stat(input.filePath)).size;
+        const mimeType = input.mimeType ?? mimeTypeForPath(input.filePath);
+        const upload = await this.request("POST", "/artifact-files/upload-url", {
+            fileName,
+            mimeType,
+            sizeBytes,
+        });
+        const bytes = await readFile(input.filePath);
+        await this.putToUploadUrl(upload.uploadUrl, bytes, mimeType);
+        const result = await this.request("POST", "/artifact-files", {
+            fileKey: upload.fileKey,
+            fileName,
+            mimeType,
+            sizeBytes,
+            source: "upload",
+        });
+        this.invalidateCache();
+        return result;
+    }
+    async createTests(tests) {
+        const result = await this.request("POST", "/tests", { tests });
+        this.invalidateCache();
+        return result;
+    }
+    async updateTests(tests) {
+        const result = await this.request("PATCH", "/tests", { tests });
+        this.invalidateCache();
+        return result;
+    }
+    async runTests(input) {
+        const result = await this.request("POST", "/runs", input);
+        this.invalidateCache();
+        return result;
+    }
+    async getRun(runId) {
+        return this.request("GET", `/runs/${encodeURIComponent(runId)}`, undefined, { cache: true });
+    }
+    async getResult(resultId) {
+        return this.request("GET", `/results/${encodeURIComponent(resultId)}`, undefined, { cache: true });
+    }
+    async stopRun(runId) {
+        const result = await this.request("POST", `/runs/${encodeURIComponent(runId)}/stop`);
+        this.invalidateCache();
+        return result;
+    }
+}
+async function prepareAndroidUpload(filePath) {
+    const extension = extname(filePath).toLowerCase();
+    const bytes = await readFile(filePath);
+    if (extension === ".zip")
+        return { bytes };
+    if (extension !== ".apk") {
+        throw new Error("Android target upload must be an .apk or .zip file.");
+    }
+    const zip = new JSZip();
+    zip.file("platform_binary.apk", bytes);
+    return { bytes: await zip.generateAsync({ type: "nodebuffer", compression: "DEFLATE", compressionOptions: { level: 9 } }) };
+}
+function mimeTypeForPath(filePath) {
+    switch (extname(filePath).toLowerCase()) {
+        case ".csv":
+            return "text/csv";
+        case ".json":
+            return "application/json";
+        case ".txt":
+            return "text/plain";
+        case ".png":
+            return "image/png";
+        case ".jpg":
+        case ".jpeg":
+            return "image/jpeg";
+        case ".pdf":
+            return "application/pdf";
+        case ".zip":
+            return "application/zip";
+        default:
+            return "application/octet-stream";
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"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"}

package/dist/formatters.d.ts

@@ -0,0 +1,31 @@
+export declare function textResult(text: string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function errorResult(error: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: true;
+};
+export declare function rawOrProse(rawJson: boolean | undefined, data: unknown, formatter: (data: any) => string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function humanError(error: unknown): string;
+export declare function formatWorkspace(data: any): string;
+export declare function formatWorkspaceItem(data: any): string;
+export declare function formatAccountCreated(data: any): string;
+export declare function formatCategoryCreated(data: any): string;
+export declare function formatTargetCreated(data: any): string;
+export declare function formatArtifactFileUploaded(data: any): string;
+export declare function formatTestsChanged(data: any, verb: "Created" | "Updated"): string;
+export declare function formatRunStarted(data: any): string;
+export declare function formatRun(data: any): string;
+export declare function formatResult(data: any): string;
+export declare function formatStopRun(data: any): string;

package/dist/formatters.js

@@ -0,0 +1,190 @@
+import { DoksiApiError } from "./types.js";
+export function textResult(text) {
+    return { content: [{ type: "text", text }] };
+}
+export function errorResult(error) {
+    return {
+        content: [{ type: "text", text: humanError(error) }],
+        isError: true,
+    };
+}
+export function rawOrProse(rawJson, data, formatter) {
+    return textResult(rawJson ? JSON.stringify(data) : formatter(data));
+}
+export function humanError(error) {
+    if (error instanceof DoksiApiError) {
+        const parsed = parseErrorBody(error.responseBody);
+        return `Doksi API error (${error.statusCode}): ${parsed}`;
+    }
+    return error instanceof Error ? error.message : String(error);
+}
+function parseErrorBody(body) {
+    try {
+        const json = JSON.parse(body);
+        return json.error ?? json.message ?? body;
+    }
+    catch {
+        return body;
+    }
+}
+export function formatWorkspace(data) {
+    const sections = data?.sections ?? {};
+    const lines = ["Workspace context:"];
+    appendList(lines, "Tests", sections.tests, formatTestLine);
+    appendList(lines, "Runs", sections.runs, formatRunLine);
+    appendList(lines, "Targets", sections.targets, formatTargetLine);
+    appendList(lines, "Accounts", sections.accounts, formatAccountLine);
+    appendList(lines, "Categories", sections.categories, formatCategoryLine);
+    appendList(lines, "Artifact files", sections.artifactFiles, formatArtifactFileLine);
+    lines.push("");
+    lines.push(`Next: use IDs above with create_tests, run_tests, or get_workspace_item. For more, repeat search_workspace with skip=${Number(data?.skip ?? 0) + Number(data?.limit ?? 20)}.`);
+    return lines.join("\n");
+}
+export function formatWorkspaceItem(data) {
+    const kind = data?.kind ?? "item";
+    const item = data?.item ?? data;
+    if (kind === "tests") {
+        const categories = (item.categories ?? []).map((category) => category.name).join(", ") || "uncategorized";
+        const artifacts = item.artifacts?.length ? `${item.artifacts.length} artifact${item.artifacts.length === 1 ? "" : "s"}` : "no artifacts";
+        return `Test "${item.name}" - id ${item.id}.
+
+Priority: ${item.priority ?? "medium"}.
+Categories: ${categories}.
+Artifacts: ${artifacts}.
+
+Description:
+${item.description ?? ""}
+
+Expectation:
+${item.expectation ?? ""}
+
+Next: update with update_tests or run with run_tests.`;
+    }
+    if (kind === "accounts") {
+        const fields = Object.keys(item.nonSensitiveFields ?? {}).join(", ") || "only secret fields, hidden";
+        return `Account "${item.name}" - id ${item.id}.
+
+Visible fields: ${fields}.
+Usage context: ${item.usageContext || "none"}.
+Secrets are stored by Doksi and are not returned.`;
+    }
+    if (kind === "targets") {
+        const detail = item.packageName ?? item.url ?? item.category ?? "no target detail";
+        return `Target "${item.name}" - id ${item.id}.
+
+Type: ${item.type ?? "unknown"}.
+Detail: ${detail}.
+
+Next: use target id ${item.id} with run_tests.`;
+    }
+    if (kind === "categories") {
+        return `Category "${item.name}" - id ${item.id}.
+
+Tests: ${item.testsCount ?? 0}.
+Color: ${item.color ?? "not set"}.`;
+    }
+    if (kind === "artifact-files") {
+        return `Artifact file "${item.fileName}" - id ${item.id}.
+
+Status: ${item.status ?? "unknown"}.
+MIME type: ${item.mimeType ?? "unknown"}.
+Size: ${item.sizeBytes ?? 0} bytes.
+
+Next: use file id ${item.id} in a file parameter artifact.`;
+    }
+    return keyValueSummary(`Workspace ${kind}`, item);
+}
+export function formatAccountCreated(data) {
+    const account = data?.account;
+    return `Created account "${account?.name}" with id ${account?.id}.\n\nVisible fields: ${Object.keys(account?.nonSensitiveFields ?? {}).join(", ") || "none"}. Secrets are stored but not returned.\n\nNext: use account id ${account?.id} in run_tests or test artifacts when a specific account is required.`;
+}
+export function formatCategoryCreated(data) {
+    const category = data?.category;
+    return `Created category "${category?.name}" with id ${category?.id}.\n\nNext: use category id ${category?.id} in create_tests.`;
+}
+export function formatTargetCreated(data) {
+    const target = data?.target;
+    const detail = target?.packageName ? ` Package ${target.packageName}.` : target?.url ? ` URL ${target.url}.` : "";
+    return `Created target "${target?.name}" with id ${target?.id}.${detail}\n\nNext: use target id ${target?.id} in run_tests.`;
+}
+export function formatArtifactFileUploaded(data) {
+    const file = data?.file;
+    const parameter = data?.parameter;
+    const devicePath = parameter?.file?.devicePath;
+    return `Uploaded artifact file "${file?.fileName}" with id ${file?.id}.\n\nUse it as a file parameter with fileId ${file?.id} and device path ${devicePath}.`;
+}
+export function formatTestsChanged(data, verb) {
+    const tests = data?.tests ?? [];
+    const lines = [`${verb} ${tests.length} test${tests.length === 1 ? "" : "s"}.`];
+    tests.forEach((test, index) => lines.push(`${index + 1}. ${test.name} - id ${test.id} - priority ${test.priority ?? "medium"}`));
+    lines.push("");
+    lines.push("Next: call run_tests with these test IDs and a target ID.");
+    return lines.join("\n");
+}
+export function formatRunStarted(data) {
+    const run = data?.run;
+    const resultIds = run?.resultIds ?? [];
+    return `Started run ${run?.id} (${run?.runId ?? "no short id"}) with ${data?.requestedSessions ?? run?.sessionsCount ?? 0} requested session${(data?.requestedSessions ?? 0) === 1 ? "" : "s"}.\n\nFirst session id: ${data?.firstSessionId ?? "pending"}.\nResult ids: ${resultIds.length ? resultIds.join(", ") : "results are still being created"}.\n\nNext: poll get_run with run id ${run?.id}.`;
+}
+export function formatRun(data) {
+    const run = data?.run ?? data;
+    const counts = run?.resultCountsByStatus ?? {};
+    const countText = Object.keys(counts).length ? Object.entries(counts).map(([k, v]) => `${k}: ${v}`).join(", ") : "no results yet";
+    return `Run ${run?.id} (${run?.runId ?? "no short id"}): ${countText}.\n\nResult ids: ${(run?.resultIds ?? []).join(", ") || "none yet"}.\nNext: call get_result for a completed or failed result id.`;
+}
+export function formatResult(data) {
+    const result = data?.result ?? data?.item ?? data;
+    const summary = result?.extendedSummary?.summary ?? result?.summary ?? "No summary yet.";
+    return `Result ${result?.id} for test ${result?.testId}: ${result?.status}.\n\nSummary: ${summary}\n\nIssues: ${result?.issuesCount ?? 0}.\nNavigation session: ${result?.navigationSessionId ?? "none"}.`;
+}
+function keyValueSummary(title, item) {
+    if (!item || typeof item !== "object")
+        return `${title}: ${String(item)}`;
+    const lines = [`${title}:`];
+    for (const [key, value] of Object.entries(item)) {
+        if (value === undefined || value === null)
+            continue;
+        if (Array.isArray(value)) {
+            lines.push(`${key}: ${value.length} item${value.length === 1 ? "" : "s"}`);
+        }
+        else if (typeof value === "object") {
+            lines.push(`${key}: present`);
+        }
+        else {
+            lines.push(`${key}: ${String(value)}`);
+        }
+    }
+    return lines.join("\n");
+}
+export function formatStopRun(data) {
+    return `Stopped ${data?.stopped ?? 0} of ${data?.total ?? 0} active result${(data?.total ?? 0) === 1 ? "" : "s"}.\n\nFailed result ids: ${(data?.failedIds ?? []).join(", ") || "none"}.`;
+}
+function appendList(lines, title, items, formatter) {
+    if (!items?.length)
+        return;
+    lines.push("");
+    lines.push(`${title}:`);
+    items.forEach((item, index) => lines.push(formatter(item, index)));
+}
+function formatTestLine(test, index) {
+    const categories = (test.categories ?? []).map((c) => c.name).join(", ") || "uncategorized";
+    return `${index + 1}. ${test.name} - id ${test.id} - ${categories} - ${test.priority ?? "medium"}`;
+}
+function formatRunLine(run, index) {
+    return `${index + 1}. Run ${run.numericId ?? run.runId ?? run.id} - id ${run.id} - ${run.sessionsCount ?? 0} sessions`;
+}
+function formatTargetLine(target, index) {
+    const detail = target.packageName ?? target.url ?? target.category ?? "";
+    return `${index + 1}. ${target.name} - id ${target.id}${detail ? ` - ${detail}` : ""}`;
+}
+function formatAccountLine(account, index) {
+    const fields = Object.keys(account.nonSensitiveFields ?? {}).join(", ") || "secret fields hidden";
+    return `${index + 1}. ${account.name} - id ${account.id} - ${fields}`;
+}
+function formatCategoryLine(category, index) {
+    return `${index + 1}. ${category.name} - id ${category.id} - ${category.testsCount ?? 0} tests`;
+}
+function formatArtifactFileLine(file, index) {
+    return `${index + 1}. ${file.fileName} - id ${file.id} - ${file.status ?? "ready"} - ${file.sizeBytes ?? 0} bytes`;
+}
+//# sourceMappingURL=formatters.js.map

package/dist/formatters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.js","sourceRoot":"","sources":["../src/formatters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7D,OAAO,EAAE,IAAa;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAA4B,EAAE,IAAa,EAAE,SAAgC;IACtG,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAClD,OAAO,oBAAoB,KAAK,CAAC,UAAU,MAAM,MAAM,EAAE,CAAC;IAC5D,CAAC;IACD,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAyC,CAAC;QACtE,OAAO,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAS;IACvC,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC;IACtC,MAAM,KAAK,GAAG,CAAC,oBAAoB,CAAC,CAAC;IACrC,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;IAC3D,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACxD,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;IACjE,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IACpE,UAAU,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;IACzE,UAAU,CAAC,KAAK,EAAE,gBAAgB,EAAE,QAAQ,CAAC,aAAa,EAAE,sBAAsB,CAAC,CAAC;IACpF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,wHAAwH,MAAM,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;IAC3L,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAS;IAC3C,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,MAAM,CAAC;IAClC,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC;IAChC,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAa,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC;QAC/G,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,YAAY,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC;QACzI,OAAO,SAAS,IAAI,CAAC,IAAI,UAAU,IAAI,CAAC,EAAE;;YAElC,IAAI,CAAC,QAAQ,IAAI,QAAQ;cACvB,UAAU;aACX,SAAS;;;EAGpB,IAAI,CAAC,WAAW,IAAI,EAAE;;;EAGtB,IAAI,CAAC,WAAW,IAAI,EAAE;;sDAE8B,CAAC;IACrD,CAAC;IAED,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,4BAA4B,CAAC;QACrG,OAAO,YAAY,IAAI,CAAC,IAAI,UAAU,IAAI,CAAC,EAAE;;kBAE/B,MAAM;iBACP,IAAI,CAAC,YAAY,IAAI,MAAM;kDACM,CAAC;IACjD,CAAC;IAED,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,QAAQ,IAAI,kBAAkB,CAAC;QACnF,OAAO,WAAW,IAAI,CAAC,IAAI,UAAU,IAAI,CAAC,EAAE;;QAExC,IAAI,CAAC,IAAI,IAAI,SAAS;UACpB,MAAM;;sBAEM,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC9C,CAAC;IAED,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;QAC1B,OAAO,aAAa,IAAI,CAAC,IAAI,UAAU,IAAI,CAAC,EAAE;;SAEzC,IAAI,CAAC,UAAU,IAAI,CAAC;SACpB,IAAI,CAAC,KAAK,IAAI,SAAS,GAAG,CAAC;IAClC,CAAC;IAED,IAAI,IAAI,KAAK,gBAAgB,EAAE,CAAC;QAC9B,OAAO,kBAAkB,IAAI,CAAC,QAAQ,UAAU,IAAI,CAAC,EAAE;;UAEjD,IAAI,CAAC,MAAM,IAAI,SAAS;aACrB,IAAI,CAAC,QAAQ,IAAI,SAAS;QAC/B,IAAI,CAAC,SAAS,IAAI,CAAC;;oBAEP,IAAI,CAAC,EAAE,gCAAgC,CAAC;IAC1D,CAAC;IAED,OAAO,eAAe,CAAC,aAAa,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAS;IAC5C,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,CAAC;IAC9B,OAAO,oBAAoB,OAAO,EAAE,IAAI,aAAa,OAAO,EAAE,EAAE,wBAAwB,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,kEAAkE,OAAO,EAAE,EAAE,sEAAsE,CAAC;AACjT,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAS;IAC7C,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,CAAC;IAChC,OAAO,qBAAqB,QAAQ,EAAE,IAAI,aAAa,QAAQ,EAAE,EAAE,8BAA8B,QAAQ,EAAE,EAAE,mBAAmB,CAAC;AACnI,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAS;IAC3C,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,CAAC;IAC5B,MAAM,MAAM,GAAG,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,YAAY,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAClH,OAAO,mBAAmB,MAAM,EAAE,IAAI,aAAa,MAAM,EAAE,EAAE,IAAI,MAAM,2BAA2B,MAAM,EAAE,EAAE,gBAAgB,CAAC;AAC/H,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,IAAS;IAClD,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,CAAC;IACxB,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,CAAC;IAClC,MAAM,UAAU,GAAG,SAAS,EAAE,IAAI,EAAE,UAAU,CAAC;IAC/C,OAAO,2BAA2B,IAAI,EAAE,QAAQ,aAAa,IAAI,EAAE,EAAE,+CAA+C,IAAI,EAAE,EAAE,oBAAoB,UAAU,GAAG,CAAC;AAChK,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAS,EAAE,IAA2B;IACvE,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,IAAI,KAAK,CAAC,MAAM,QAAQ,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IAChF,KAAK,CAAC,OAAO,CAAC,CAAC,IAAS,EAAE,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,eAAe,IAAI,CAAC,QAAQ,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC9I,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;IACxE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAS;IACxC,MAAM,GAAG,GAAG,IAAI,EAAE,GAAG,CAAC;IACtB,MAAM,SAAS,GAAG,GAAG,EAAE,SAAS,IAAI,EAAE,CAAC;IACvC,OAAO,eAAe,GAAG,EAAE,EAAE,KAAK,GAAG,EAAE,KAAK,IAAI,aAAa,UAAU,IAAI,EAAE,iBAAiB,IAAI,GAAG,EAAE,aAAa,IAAI,CAAC,qBAAqB,CAAC,IAAI,EAAE,iBAAiB,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,0BAA0B,IAAI,EAAE,cAAc,IAAI,SAAS,kBAAkB,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,iCAAiC,uCAAuC,GAAG,EAAE,EAAE,GAAG,CAAC;AACzY,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAS;IACjC,MAAM,GAAG,GAAG,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC;IAC9B,MAAM,MAAM,GAAG,GAAG,EAAE,oBAAoB,IAAI,EAAE,CAAC;IAC/C,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC;IAClI,OAAO,OAAO,GAAG,EAAE,EAAE,KAAK,GAAG,EAAE,KAAK,IAAI,aAAa,MAAM,SAAS,oBAAoB,CAAC,GAAG,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,UAAU,+DAA+D,CAAC;AACzM,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAS;IACpC,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC;IAClD,MAAM,OAAO,GAAG,MAAM,EAAE,eAAe,EAAE,OAAO,IAAI,MAAM,EAAE,OAAO,IAAI,iBAAiB,CAAC;IACzF,OAAO,UAAU,MAAM,EAAE,EAAE,aAAa,MAAM,EAAE,MAAM,KAAK,MAAM,EAAE,MAAM,iBAAiB,OAAO,eAAe,MAAM,EAAE,WAAW,IAAI,CAAC,0BAA0B,MAAM,EAAE,mBAAmB,IAAI,MAAM,GAAG,CAAC;AAC7M,CAAC;AAED,SAAS,eAAe,CAAC,KAAa,EAAE,IAAS;IAC/C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,GAAG,KAAK,KAAK,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;IAC1E,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;IAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS;QACpD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,KAAK,CAAC,MAAM,QAAQ,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QAC7E,CAAC;aAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,WAAW,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAS;IACrC,OAAO,WAAW,IAAI,EAAE,OAAO,IAAI,CAAC,OAAO,IAAI,EAAE,KAAK,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,2BAA2B,CAAC,IAAI,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,GAAG,CAAC;AAC5L,CAAC;AAED,SAAS,UAAU,CAAC,KAAe,EAAE,KAAa,EAAE,KAAwB,EAAE,SAA+C;IAC3H,IAAI,CAAC,KAAK,EAAE,MAAM;QAAE,OAAO;IAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;IACxB,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,cAAc,CAAC,IAAS,EAAE,KAAa;IAC9C,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC;IACjG,OAAO,GAAG,KAAK,GAAG,CAAC,KAAK,IAAI,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,MAAM,UAAU,MAAM,IAAI,CAAC,QAAQ,IAAI,QAAQ,EAAE,CAAC;AACrG,CAAC;AAED,SAAS,aAAa,CAAC,GAAQ,EAAE,KAAa;IAC5C,OAAO,GAAG,KAAK,GAAG,CAAC,SAAS,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,EAAE,SAAS,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC,aAAa,IAAI,CAAC,WAAW,CAAC;AACzH,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAW,EAAE,KAAa;IAClD,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;IACzE,OAAO,GAAG,KAAK,GAAG,CAAC,KAAK,MAAM,CAAC,IAAI,SAAS,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACzF,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAY,EAAE,KAAa;IACpD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,sBAAsB,CAAC;IAClG,OAAO,GAAG,KAAK,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,SAAS,OAAO,CAAC,EAAE,MAAM,MAAM,EAAE,CAAC;AACxE,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAa,EAAE,KAAa;IACtD,OAAO,GAAG,KAAK,GAAG,CAAC,KAAK,QAAQ,CAAC,IAAI,SAAS,QAAQ,CAAC,EAAE,MAAM,QAAQ,CAAC,UAAU,IAAI,CAAC,QAAQ,CAAC;AAClG,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAS,EAAE,KAAa;IACtD,OAAO,GAAG,KAAK,GAAG,CAAC,KAAK,IAAI,CAAC,QAAQ,SAAS,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,IAAI,CAAC,SAAS,IAAI,CAAC,QAAQ,CAAC;AACrH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+async function main() {
+    const apiKey = process.env.DOKSI_API_KEY;
+    if (!apiKey) {
+        console.error("Error: DOKSI_API_KEY environment variable is required");
+        process.exit(1);
+    }
+    const apiUrl = process.env.DOKSI_API_URL || "https://api.doksi.ai";
+    const server = createServer(apiUrl, apiKey);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;IACzC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC;QACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,sBAAsB,CAAC;IACnE,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/prompts.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerPrompts(server: McpServer): void;

package/dist/prompts.js

@@ -0,0 +1,133 @@
+import { z } from "zod";
+export function registerPrompts(server) {
+    const mcp = server;
+    mcp.registerPrompt("create_tests_from_prd", {
+        title: "Create Doksi Tests From PRD",
+        description: "Plan and create Doksi tests from product requirements.",
+        argsSchema: {
+            prd: z.string().describe("The PRD, feature brief, or requirements text."),
+        },
+    }, ({ prd }) => ({
+        messages: [{
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Use Doksi MCP to create focused tests from this PRD.
+
+Workflow:
+1. Read doksi://workspace/summary or call search_workspace.
+2. Reuse existing targets, accounts, categories, and artifact files when possible.
+3. Create missing categories with add_category.
+4. Create tests with create_tests. Do not run yet unless asked.
+
+PRD:
+${prd}`,
+                },
+            }],
+    }));
+    mcp.registerPrompt("run_tests_for_prd", {
+        title: "Run Doksi Tests For PRD",
+        description: "Find or create relevant tests for a PRD and run them on a Doksi target.",
+        argsSchema: {
+            prd: z.string(),
+            targetHint: z.string().optional(),
+        },
+    }, ({ prd, targetHint }) => ({
+        messages: [{
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Use Doksi MCP to run relevant coverage for this PRD.
+
+Workflow:
+1. Read doksi://workspace/summary or call search_workspace.
+2. Find the best target${targetHint ? ` matching this hint: ${targetHint}` : ""}.
+3. Reuse existing tests when they cover the PRD.
+4. Create missing tests with create_tests.
+5. Run with run_tests.
+6. Poll with get_run and inspect failures with get_result.
+
+PRD:
+${prd}`,
+                },
+            }],
+    }));
+    mcp.registerPrompt("create_tests_from_user_stories", {
+        title: "Create Doksi Tests From User Stories",
+        description: "Plan and create Doksi tests from user stories or acceptance criteria.",
+        argsSchema: {
+            userStories: z.string().describe("User stories, acceptance criteria, Gherkin scenarios, or requirements text."),
+        },
+    }, ({ userStories }) => ({
+        messages: [{
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Use Doksi MCP to create focused tests from these user stories.
+
+Workflow:
+1. Read doksi://workspace/summary or call search_workspace.
+2. Identify committed, user-visible behaviors. Skip notes, implementation tasks, open questions, analytics-only goals, and duplicate intent.
+3. Split independent acceptance criteria into separate tests when they have different actors, preconditions, branches, or assertions.
+4. Reuse existing tests, categories, accounts, and artifact files when possible.
+5. Create missing categories with add_category.
+6. Create tests with create_tests. Do not run yet unless asked.
+
+User stories:
+${userStories}`,
+                },
+            }],
+    }));
+    mcp.registerPrompt("run_tests_for_user_stories", {
+        title: "Run Doksi Tests For User Stories",
+        description: "Find or create relevant tests for user stories and run them on a Doksi target.",
+        argsSchema: {
+            userStories: z.string().describe("User stories, acceptance criteria, Gherkin scenarios, or requirements text."),
+            targetHint: z.string().optional(),
+        },
+    }, ({ userStories, targetHint }) => ({
+        messages: [{
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Use Doksi MCP to run relevant coverage for these user stories.
+
+Workflow:
+1. Read doksi://workspace/summary or call search_workspace.
+2. Find the best target${targetHint ? ` matching this hint: ${targetHint}` : ""}.
+3. Reuse existing tests when they cover the same behavior and expected outcome.
+4. Create missing tests with create_tests.
+5. Run with run_tests.
+6. Poll with get_run and inspect failures with get_result.
+
+User stories:
+${userStories}`,
+                },
+            }],
+    }));
+    mcp.registerPrompt("audit_existing_tests", {
+        title: "Audit Existing Doksi Tests",
+        description: "Compare an existing Doksi test set against requirements and suggest gaps.",
+        argsSchema: {
+            requirements: z.string(),
+        },
+    }, ({ requirements }) => ({
+        messages: [{
+                role: "user",
+                content: {
+                    type: "text",
+                    text: `Audit Doksi coverage against these requirements.
+
+Workflow:
+1. Read doksi://workspace/summary.
+2. Use search_workspace and get_workspace_item for relevant test details.
+3. Summarize covered, partially covered, and missing requirements.
+4. Only call create_tests if explicitly asked.
+
+Requirements:
+${requirements}`,
+                },
+            }],
+    }));
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"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"}

package/dist/resources.d.ts

@@ -0,0 +1,3 @@
+import { type McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { DoksiApiClient } from "./api-client.js";
+export declare function registerResources(server: McpServer, client: DoksiApiClient): void;

package/dist/resources.js

@@ -0,0 +1,78 @@
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { formatResult, formatRun, formatWorkspace, formatWorkspaceItem } from "./formatters.js";
+export function registerResources(server, client) {
+    const mcp = server;
+    mcp.registerResource("workspace_summary", "doksi://workspace/summary", {
+        title: "Doksi Workspace Summary",
+        description: "Compact current workspace context. Read this before creating or running tests.",
+        mimeType: "text/plain",
+    }, async (uri) => ({
+        contents: [{
+                uri: uri.href,
+                mimeType: "text/plain",
+                text: formatWorkspace(await client.searchWorkspace({ limit: 10 })),
+            }],
+    }));
+    mcp.registerResource("test_definition_schema", "doksi://schema/test-definition", {
+        title: "Doksi Test Definition Schema",
+        description: "How to author tests and artifacts for create_tests/update_tests.",
+        mimeType: "text/markdown",
+    }, async (uri) => ({
+        contents: [{
+                uri: uri.href,
+                mimeType: "text/markdown",
+                text: testDefinitionSchema(),
+            }],
+    }));
+    registerItemResource(server, client, "test", "doksi://tests/{test_id}", "tests", formatWorkspaceItem);
+    registerItemResource(server, client, "run", "doksi://runs/{run_id}", "runs", (data) => formatRun({ run: data.item }));
+    registerItemResource(server, client, "result", "doksi://results/{result_id}", "results", (data) => formatResult({ result: data.item }));
+    registerItemResource(server, client, "target", "doksi://targets/{target_id}", "targets", formatWorkspaceItem);
+    registerItemResource(server, client, "artifact_file", "doksi://artifact-files/{file_id}", "artifact-files", formatWorkspaceItem);
+}
+function registerItemResource(server, client, name, template, kind, formatter) {
+    server.registerResource(name, new ResourceTemplate(template, { list: undefined }), {
+        title: `Doksi ${name.replace("_", " ")}`,
+        description: `Detailed Doksi ${name.replace("_", " ")} context.`,
+        mimeType: "text/plain",
+    }, async (uri, variables) => {
+        const id = String(Object.values(variables)[0] ?? "");
+        const data = await client.getWorkspaceItem({ kind, id });
+        return {
+            contents: [{
+                    uri: uri.href,
+                    mimeType: "text/plain",
+                    text: formatter(data),
+                }],
+        };
+    });
+}
+function testDefinitionSchema() {
+    return `# Doksi Test Definition
+
+Use \`create_tests\` with:
+
+\`\`\`json
+{
+  "tests": [
+    {
+      "name": "Checkout accepts a valid card",
+      "description": "Steps the agent should perform. Reference parameters as {{parameter:Name}}.",
+      "expectation": "Observable pass/fail expectation.",
+      "categoryIds": ["category_id"],
+      "priority": "medium",
+      "artifacts": [
+        { "type": "account", "strategy": "specific", "accountId": "account_id" },
+        { "type": "parameter", "name": "Promo Code", "kind": "text", "text": { "value": "SAVE10" } },
+        { "type": "parameter", "name": "contacts.csv", "kind": "file", "file": { "fileId": "file_id", "devicePath": "/sdcard/Download/contacts.csv" } }
+      ]
+    }
+  ]
+}
+\`\`\`
+
+Do not include target artifacts on tests for normal PRD workflows. Supply target id to \`run_tests\`.
+
+Validation is internal to \`create_tests\` and \`update_tests\`. If validation fails, repair the named field or parameter and retry.`;
+}
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function createServer(apiUrl: string, apiKey: string): McpServer;

package/dist/server.js

@@ -0,0 +1,24 @@
+import { readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { DoksiApiClient } from "./api-client.js";
+import { registerTools } from "./tools.js";
+import { registerResources } from "./resources.js";
+import { registerPrompts } from "./prompts.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const instructions = readFileSync(join(__dirname, "../SKILL.md"), "utf-8");
+export function createServer(apiUrl, apiKey) {
+    const server = new McpServer({
+        name: "Doksi MCP",
+        version: "0.1.0",
+        websiteUrl: "https://doksi.ai",
+        description: "Create, inspect, and run Doksi tests from an LLM.",
+    }, { instructions });
+    const client = new DoksiApiClient(apiUrl, apiKey);
+    registerResources(server, client);
+    registerPrompts(server);
+    registerTools(server, client);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,YAAY,GAAG,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE,OAAO,CAAC,CAAC;AAE3E,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,MAAc;IACzD,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;QAChB,UAAU,EAAE,kBAAkB;QAC9B,WAAW,EAAE,mDAAmD;KACjE,EACD,EAAE,YAAY,EAAE,CACjB,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,eAAe,CAAC,MAAM,CAAC,CAAC;IACxB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { DoksiApiClient } from "./api-client.js";
+export declare function registerTools(server: McpServer, client: DoksiApiClient): void;

package/dist/tools.js

@@ -0,0 +1,218 @@
+import { z } from "zod";
+import { errorResult, formatAccountCreated, formatArtifactFileUploaded, formatCategoryCreated, formatResult, formatRun, formatRunStarted, formatStopRun, formatTargetCreated, formatTestsChanged, formatWorkspace, formatWorkspaceItem, rawOrProse, } from "./formatters.js";
+const rawJson = z.boolean().optional().describe("Return compact JSON text instead of the default natural-language response.");
+const priority = z.string().optional().describe("Priority: low, medium, high, critical. Severity aliases like major/minor are accepted.");
+const artifact = z.unknown().describe("Doksi artifact object. Use parameter/account artifacts only on tests; run_tests supplies target artifacts.");
+const testDefinition = z.object({
+    testId: z.string().optional(),
+    name: z.string(),
+    description: z.string(),
+    expectation: z.string(),
+    categoryIds: z.array(z.string()).optional(),
+    priority,
+    artifacts: z.array(artifact).optional(),
+});
+export function registerTools(server, client) {
+    const mcp = server;
+    mcp.registerTool("search_workspace", {
+        description: "Search or list compact Doksi workspace context: tests, runs, targets, accounts, categories, and artifact files. Use this before creating or running tests so you can reuse existing IDs. Returns concise prose by default.",
+        inputSchema: {
+            kinds: z.array(z.enum(["tests", "runs", "targets", "accounts", "categories", "artifact-files"])).optional(),
+            search: z.string().optional(),
+            limit: z.number().int().min(1).max(50).optional(),
+            skip: z.number().int().min(0).optional(),
+            rawJson,
+        },
+    }, async (input) => {
+        try {
+            const data = await client.searchWorkspace(input);
+            return rawOrProse(input.rawJson, data, formatWorkspace);
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+    mcp.registerTool("get_workspace_item", {
+        description: "Fetch detailed context for one workspace item by id. Use when search_workspace gives an ID but you need the full test, run, result, target, account, category, or artifact-file detail.",
+        inputSchema: {
+            kind: z.enum(["tests", "runs", "results", "targets", "accounts", "categories", "artifact-files"]),
+            id: z.string(),
+            rawJson,
+        },
+    }, async (input) => {
+        try {
+            const data = await client.getWorkspaceItem(input);
+            return rawOrProse(input.rawJson, data, formatWorkspaceItem);
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+    mcp.registerTool("add_account", {
+        description: "Create a reusable Doksi account. Use this only when an existing account cannot be reused. Secrets are stored by Doksi and never returned in tool output.",
+        inputSchema: {
+            name: z.string(),
+            fieldValues: z.record(z.string()).describe("Authentication fields, for example {\"email\":\"pm@example.com\",\"password\":\"...\"}. Sensitive values are accepted but never echoed back."),
+            usageContext: z.string().optional(),
+            rawJson,
+        },
+    }, async (input) => {
+        try {
+            const data = await client.addAccount(input);
+            return rawOrProse(input.rawJson, data, formatAccountCreated);
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+    mcp.registerTool("add_category", {
+        description: "Create a test category. Use categories to group tests generated from a PRD area or feature.",
+        inputSchema: {
+            name: z.string(),
+            color: z.string().optional(),
+            rawJson,
+        },
+    }, async (input) => {
+        try {
+            const data = await client.addCategory(input);
+            return rawOrProse(input.rawJson, data, formatCategoryCreated);
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+    mcp.registerTool("add_target", {
+        description: "Create a reusable test target. For Android, pass filePath to a local .apk or .zip; the MCP uploads directly to S3 and Doksi reconciles the target. For web, pass url. Use the returned target id in run_tests.",
+        inputSchema: {
+            name: z.string().optional(),
+            filePath: z.string().optional(),
+            url: z.string().optional(),
+            category: z.enum(["android", "web"]).optional(),
+            platformType: z.string().optional(),
+            rawJson,
+        },
+    }, async (input) => {
+        try {
+            const data = await client.addTarget(input);
+            return rawOrProse(input.rawJson, data, formatTargetCreated);
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+    mcp.registerTool("upload_artifact_file", {
+        description: "Upload a parameter file for tests, such as CSVs, images, PDFs, or fixture documents. Use the returned fileId in file parameter artifacts.",
+        inputSchema: {
+            filePath: z.string(),
+            name: z.string().optional(),
+            mimeType: z.string().optional(),
+            rawJson,
+        },
+    }, async (input) => {
+        try {
+            const data = await client.uploadArtifactFile(input);
+            return rawOrProse(input.rawJson, data, formatArtifactFileUploaded);
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+    mcp.registerTool("create_tests", {
+        description: "Create one or many Doksi tests from LLM-authored definitions. Validation happens internally; errors are returned in natural language so you can repair the definitions and retry.",
+        inputSchema: {
+            tests: z.array(testDefinition).min(1),
+            rawJson,
+        },
+    }, async (input) => {
+        try {
+            const data = await client.createTests(input.tests);
+            return rawOrProse(input.rawJson, data, (d) => formatTestsChanged(d, "Created"));
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+    mcp.registerTool("update_tests", {
+        description: "Update one or many existing Doksi tests. Every item requires testId. Use this to revise tests after inspecting existing coverage or validation feedback.",
+        inputSchema: {
+            tests: z.array(testDefinition.extend({ testId: z.string() })).min(1),
+            rawJson,
+        },
+    }, async (input) => {
+        try {
+            const data = await client.updateTests(input.tests);
+            return rawOrProse(input.rawJson, data, (d) => formatTestsChanged(d, "Updated"));
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+    mcp.registerTool("run_tests", {
+        description: "Run one or many tests on a target. Target is run-level; account and parameter overrides are optional. Use get_run to poll and get_result for details.",
+        inputSchema: {
+            testIds: z.array(z.string()).min(1),
+            targetId: z.string(),
+            account: z.object({
+                strategy: z.enum(["none", "generated", "specific"]).optional(),
+                accountId: z.string().optional(),
+            }).optional(),
+            parameters: z.array(artifact).optional(),
+            artifacts: z.array(artifact).optional(),
+            rawJson,
+        },
+    }, async (input) => {
+        try {
+            const data = await client.runTests(input);
+            return rawOrProse(input.rawJson, data, formatRunStarted);
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+    mcp.registerTool("get_run", {
+        description: "Poll a Doksi run by id. Use this after run_tests until results complete.",
+        inputSchema: {
+            runId: z.string(),
+            rawJson,
+        },
+    }, async (input) => {
+        try {
+            const data = await client.getRun(input.runId);
+            return rawOrProse(input.rawJson, data, formatRun);
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+    mcp.registerTool("get_result", {
+        description: "Fetch concise details for one result. Use this for failures, incomplete sessions, or completed results that need evidence.",
+        inputSchema: {
+            resultId: z.string(),
+            rawJson,
+        },
+    }, async (input) => {
+        try {
+            const data = await client.getResult(input.resultId);
+            return rawOrProse(input.rawJson, data, formatResult);
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+    mcp.registerTool("stop_run", {
+        description: "Stop active or queued results in a Doksi run.",
+        inputSchema: {
+            runId: z.string(),
+            rawJson,
+        },
+    }, async (input) => {
+        try {
+            const data = await client.stopRun(input.runId);
+            return rawOrProse(input.rawJson, data, formatStopRun);
+        }
+        catch (error) {
+            return errorResult(error);
+        }
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,46 @@
+export type WorkspaceKind = "tests" | "runs" | "targets" | "accounts" | "categories" | "artifact-files";
+export interface RawJsonOption {
+    rawJson?: boolean;
+}
+export interface SearchWorkspaceInput extends RawJsonOption {
+    kinds?: WorkspaceKind[];
+    search?: string;
+    limit?: number;
+    skip?: number;
+}
+export interface WorkspaceItemInput extends RawJsonOption {
+    kind: WorkspaceKind | "results";
+    id: string;
+}
+export interface TestDefinition {
+    testId?: string;
+    name: string;
+    description: string;
+    expectation: string;
+    categoryIds?: string[];
+    priority?: "low" | "medium" | "high" | "critical" | string;
+    artifacts?: unknown[];
+}
+export interface RunTestsInput extends RawJsonOption {
+    testIds: string[];
+    targetId: string;
+    account?: {
+        strategy?: "none" | "generated" | "specific";
+        accountId?: string;
+    };
+    parameters?: unknown[];
+    artifacts?: unknown[];
+}
+export interface AddTargetInput extends RawJsonOption {
+    name?: string;
+    filePath?: string;
+    url?: string;
+    category?: "android" | "web";
+    platformType?: string;
+}
+export declare class DoksiApiError extends Error {
+    readonly statusCode: number;
+    readonly responseBody: string;
+    readonly url: string;
+    constructor(statusCode: number, responseBody: string, url: string);
+}

package/dist/types.js

@@ -0,0 +1,13 @@
+export class DoksiApiError extends Error {
+    statusCode;
+    responseBody;
+    url;
+    constructor(statusCode, responseBody, url) {
+        super(`API error ${statusCode}: ${responseBody}`);
+        this.statusCode = statusCode;
+        this.responseBody = responseBody;
+        this.url = url;
+        this.name = "DoksiApiError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAqDA,MAAM,OAAO,aAAc,SAAQ,KAAK;IAEpB;IACA;IACA;IAHlB,YACkB,UAAkB,EAClB,YAAoB,EACpB,GAAW;QAE3B,KAAK,CAAC,aAAa,UAAU,KAAK,YAAY,EAAE,CAAC,CAAC;QAJlC,eAAU,GAAV,UAAU,CAAQ;QAClB,iBAAY,GAAZ,YAAY,CAAQ;QACpB,QAAG,GAAH,GAAG,CAAQ;QAG3B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@doksi/mcp",
+  "version": "0.1.1",
+  "description": "MCP server for creating, managing, and running Doksi tests",
+  "type": "module",
+  "bin": {
+    "doksi": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "scripts": {
+    "build": "tsc && chmod +x dist/index.js",
+    "dev": "tsc --watch",
+    "prepack": "npm run build",
+    "start": "node dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "SKILL.md",
+    "version.txt"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "jszip": "^3.10.1",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/version.txt

@@ -0,0 +1 @@
+1782840898