@testchimp/cli 0.1.83 → 0.1.85

package/dist/core/client.test.js

@@ -1,6 +1,6 @@
 import assert from "node:assert/strict";
-import { afterEach, describe, it } from "node:test";
-import { getBackendUrl, postMcp } from "./client.js";
+import { afterEach, beforeEach, describe, it } from "node:test";
+import { getBackendUrl, isValidBotId, postIngress, postMcp, resetClientWarningsForTests, runWithRequestAuth, } from "./client.js";
 const originalBackendUrl = process.env.TESTCHIMP_BACKEND_URL;
 const originalApiKey = process.env.TESTCHIMP_API_KEY;
 const originalFetch = globalThis.fetch;
@@ -52,3 +52,131 @@ describe("postMcp", () => {
         assert.equal(requestInit?.redirect, "manual");
     });
 });
+describe("request headers", () => {
+    const originalBotId = process.env.TESTCHIMP_BOT_ID;
+    const originalOauthToken = process.env.TESTCHIMP_OAUTH_TOKEN;
+    const originalIngressUrl = process.env.TESTCHIMP_INGRESS_URL;
+    const originalConsoleError = console.error;
+    beforeEach(() => {
+        process.env.TESTCHIMP_BACKEND_URL = "https://featureservice.example.com";
+        delete process.env.TESTCHIMP_API_KEY;
+        delete process.env.TESTCHIMP_BOT_ID;
+        delete process.env.TESTCHIMP_OAUTH_TOKEN;
+        delete process.env.TESTCHIMP_INGRESS_URL;
+        resetClientWarningsForTests();
+    });
+    afterEach(() => {
+        for (const [key, value] of [
+            ["TESTCHIMP_BOT_ID", originalBotId],
+            ["TESTCHIMP_OAUTH_TOKEN", originalOauthToken],
+            ["TESTCHIMP_INGRESS_URL", originalIngressUrl],
+        ]) {
+            if (value == null)
+                delete process.env[key];
+            else
+                process.env[key] = value;
+        }
+        console.error = originalConsoleError;
+    });
+    function captureFetch() {
+        const capture = { calls: [] };
+        globalThis.fetch = (async (input, init) => {
+            capture.calls.push({ url: String(input), init });
+            return new Response("{}", { status: 200 });
+        });
+        return capture;
+    }
+    it("sends exactly the legacy header set with an API key and no bot env", async () => {
+        process.env.TESTCHIMP_API_KEY = "test-key";
+        const capture = captureFetch();
+        await postMcp("/api/mcp/example", { a: 1 });
+        assert.equal(capture.calls[0].url, "https://featureservice.example.com/api/mcp/example");
+        assert.deepEqual(capture.calls[0].init?.headers, {
+            "Content-Type": "application/json",
+            "TestChimp-Api-Key": "test-key",
+        });
+        assert.equal(capture.calls[0].init?.body, JSON.stringify({ a: 1 }));
+    });
+    it("keeps the missing API key error when no credentials are set", async () => {
+        captureFetch();
+        await assert.rejects(postMcp("/api/mcp/example", {}), /TESTCHIMP_API_KEY is required/);
+    });
+    it("adds a valid bot-id header", async () => {
+        process.env.TESTCHIMP_API_KEY = "test-key";
+        process.env.TESTCHIMP_BOT_ID = "grok-bot_01";
+        const capture = captureFetch();
+        await postMcp("/api/mcp/example", {});
+        assert.deepEqual(capture.calls[0].init?.headers, {
+            "Content-Type": "application/json",
+            "TestChimp-Api-Key": "test-key",
+            "bot-id": "grok-bot_01",
+        });
+    });
+    it("drops an invalid bot id and warns once", async () => {
+        process.env.TESTCHIMP_API_KEY = "test-key";
+        process.env.TESTCHIMP_BOT_ID = "bad bot id";
+        const warnings = [];
+        console.error = (msg) => warnings.push(String(msg));
+        const capture = captureFetch();
+        await postMcp("/api/mcp/example", {});
+        await postMcp("/api/mcp/example", {});
+        assert.deepEqual(capture.calls[0].init?.headers, {
+            "Content-Type": "application/json",
+            "TestChimp-Api-Key": "test-key",
+        });
+        assert.equal(warnings.length, 1);
+        assert.match(warnings[0], /TESTCHIMP_BOT_ID/);
+        assert.equal(isValidBotId("x".repeat(64)), true);
+        assert.equal(isValidBotId("x".repeat(65)), false);
+        assert.equal(isValidBotId("bot\u0007"), false);
+    });
+    it("uses the OAuth token without requiring an API key", async () => {
+        process.env.TESTCHIMP_OAUTH_TOKEN = "jwt-token";
+        const capture = captureFetch();
+        await postMcp("/api/mcp/example", {});
+        assert.deepEqual(capture.calls[0].init?.headers, {
+            "Content-Type": "application/json",
+            Authorization: "Bearer jwt-token",
+        });
+    });
+    it("sends both the API key and the bearer when both are set", async () => {
+        process.env.TESTCHIMP_API_KEY = "test-key";
+        process.env.TESTCHIMP_OAUTH_TOKEN = "jwt-token";
+        process.env.TESTCHIMP_BOT_ID = "bot-1";
+        const capture = captureFetch();
+        await postMcp("/api/mcp/example", {});
+        assert.deepEqual(capture.calls[0].init?.headers, {
+            "Content-Type": "application/json",
+            "TestChimp-Api-Key": "test-key",
+            Authorization: "Bearer jwt-token",
+            "bot-id": "bot-1",
+        });
+    });
+    it("isolated request auth ignores env credentials", async () => {
+        process.env.TESTCHIMP_API_KEY = "server-key";
+        process.env.TESTCHIMP_BOT_ID = "server-bot";
+        const capture = captureFetch();
+        await runWithRequestAuth({ bearerToken: "caller-token", isolated: true }, () => postMcp("/api/mcp/example", {}));
+        assert.deepEqual(capture.calls[0].init?.headers, {
+            "Content-Type": "application/json",
+            Authorization: "Bearer caller-token",
+        });
+    });
+    it("posts to the ingress base or a trusted absolute URL", async () => {
+        process.env.TESTCHIMP_API_KEY = "test-key";
+        const capture = captureFetch();
+        await postIngress("/bot/events/ack", { eventIds: ["e1"] });
+        assert.equal(capture.calls[0].url, "https://ingress.testchimp.io/bot/events/ack");
+        assert.equal(capture.calls[0].init?.redirect, "manual");
+        await postIngress("https://ingress-staging.testchimp.io/bot/events/ack", {});
+        assert.equal(capture.calls[1].url, "https://ingress-staging.testchimp.io/bot/events/ack");
+        await postIngress("http://localhost:4302/bot/events/ack", {});
+        assert.equal(capture.calls[2].url, "http://localhost:4302/bot/events/ack");
+        await assert.rejects(postIngress("http://ingress.testchimp.io/bot/events/ack", {}), /must use https/);
+        await assert.rejects(postIngress("https://evil.example.com/bot/events/ack", {}), /untrusted ingress host/);
+        assert.equal(capture.calls.length, 3);
+        process.env.TESTCHIMP_INGRESS_URL = "https://ingress.customer.example/";
+        await postIngress("https://ingress.customer.example/bot/events/ack", {});
+        assert.equal(capture.calls[3].url, "https://ingress.customer.example/bot/events/ack");
+    });
+});

package/dist/core/schemas.d.ts

@@ -18,9 +18,9 @@ export declare const listCoverageInput: z.ZodObject<{
     includeNonCoveredTestScenarios: z.ZodOptional<z.ZodBoolean>;
     branchName: z.ZodOptional<z.ZodString>;
     platform: z.ZodOptional<z.ZodEnum<{
+        android: "android";
         web: "web";
         ios: "ios";
-        android: "android";
     }>>;
     recordTypes: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         manual: "manual";
@@ -47,9 +47,9 @@ export declare const listExecutionInput: z.ZodObject<{
     scenarioId: z.ZodOptional<z.ZodString>;
     testId: z.ZodOptional<z.ZodString>;
     platform: z.ZodOptional<z.ZodEnum<{
+        android: "android";
         web: "web";
         ios: "ios";
-        android: "android";
     }>>;
     dimensionFilters: z.ZodOptional<z.ZodArray<z.ZodObject<{
         dimension: z.ZodString;
@@ -70,9 +70,9 @@ export declare const suiteExecutionStatsInput: z.ZodObject<{
     scenarioId: z.ZodOptional<z.ZodString>;
     testId: z.ZodOptional<z.ZodString>;
     platform: z.ZodOptional<z.ZodEnum<{
+        android: "android";
         web: "web";
         ios: "ios";
-        android: "android";
     }>>;
     dimensionFilters: z.ZodOptional<z.ZodArray<z.ZodObject<{
         dimension: z.ZodString;
@@ -794,6 +794,7 @@ export declare const updateGitFolderMappingInput: z.ZodObject<{
     testsFolderPath: z.ZodOptional<z.ZodString>;
     plansFolderPath: z.ZodOptional<z.ZodString>;
     repositoryFullName: z.ZodOptional<z.ZodString>;
+    plansBranch: z.ZodOptional<z.ZodString>;
     tests_folder_path: z.ZodOptional<z.ZodString>;
     plans_folder_path: z.ZodOptional<z.ZodString>;
     repository_full_name: z.ZodOptional<z.ZodString>;
@@ -827,14 +828,14 @@ export declare const executionScopeSchema: z.ZodObject<{
     release: z.ZodOptional<z.ZodString>;
     branchName: z.ZodOptional<z.ZodString>;
     platform: z.ZodOptional<z.ZodPipe<z.ZodEnum<{
+        android: "android";
         web: "web";
         ios: "ios";
-        android: "android";
         UNKNOWN_EXECUTION_PLATFORM: "UNKNOWN_EXECUTION_PLATFORM";
         WEB_EXECUTION_PLATFORM: "WEB_EXECUTION_PLATFORM";
         IOS_EXECUTION_PLATFORM: "IOS_EXECUTION_PLATFORM";
         ANDROID_EXECUTION_PLATFORM: "ANDROID_EXECUTION_PLATFORM";
-    }>, z.ZodTransform<"UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM", "web" | "ios" | "android" | "UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM">>>;
+    }>, z.ZodTransform<"UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM", "android" | "web" | "ios" | "UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM">>>;
     automationEmitsOnly: z.ZodOptional<z.ZodBoolean>;
     metadataFilters: z.ZodOptional<z.ZodArray<z.ZodObject<{
         key: z.ZodString;
@@ -867,14 +868,14 @@ export declare const listTruecoverageEventsInput: z.ZodObject<{
         release: z.ZodOptional<z.ZodString>;
         branchName: z.ZodOptional<z.ZodString>;
         platform: z.ZodOptional<z.ZodPipe<z.ZodEnum<{
+            android: "android";
             web: "web";
             ios: "ios";
-            android: "android";
             UNKNOWN_EXECUTION_PLATFORM: "UNKNOWN_EXECUTION_PLATFORM";
             WEB_EXECUTION_PLATFORM: "WEB_EXECUTION_PLATFORM";
             IOS_EXECUTION_PLATFORM: "IOS_EXECUTION_PLATFORM";
             ANDROID_EXECUTION_PLATFORM: "ANDROID_EXECUTION_PLATFORM";
-        }>, z.ZodTransform<"UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM", "web" | "ios" | "android" | "UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM">>>;
+        }>, z.ZodTransform<"UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM", "android" | "web" | "ios" | "UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM">>>;
         automationEmitsOnly: z.ZodOptional<z.ZodBoolean>;
         metadataFilters: z.ZodOptional<z.ZodArray<z.ZodObject<{
             key: z.ZodString;
@@ -906,14 +907,14 @@ export declare const listTruecoverageEventsInput: z.ZodObject<{
         release: z.ZodOptional<z.ZodString>;
         branchName: z.ZodOptional<z.ZodString>;
         platform: z.ZodOptional<z.ZodPipe<z.ZodEnum<{
+            android: "android";
             web: "web";
             ios: "ios";
-            android: "android";
             UNKNOWN_EXECUTION_PLATFORM: "UNKNOWN_EXECUTION_PLATFORM";
             WEB_EXECUTION_PLATFORM: "WEB_EXECUTION_PLATFORM";
             IOS_EXECUTION_PLATFORM: "IOS_EXECUTION_PLATFORM";
             ANDROID_EXECUTION_PLATFORM: "ANDROID_EXECUTION_PLATFORM";
-        }>, z.ZodTransform<"UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM", "web" | "ios" | "android" | "UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM">>>;
+        }>, z.ZodTransform<"UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM", "android" | "web" | "ios" | "UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM">>>;
         automationEmitsOnly: z.ZodOptional<z.ZodBoolean>;
         metadataFilters: z.ZodOptional<z.ZodArray<z.ZodObject<{
             key: z.ZodString;
@@ -948,14 +949,14 @@ export declare const getTruecoverageEventDetailsInput: z.ZodObject<{
         release: z.ZodOptional<z.ZodString>;
         branchName: z.ZodOptional<z.ZodString>;
         platform: z.ZodOptional<z.ZodPipe<z.ZodEnum<{
+            android: "android";
             web: "web";
             ios: "ios";
-            android: "android";
             UNKNOWN_EXECUTION_PLATFORM: "UNKNOWN_EXECUTION_PLATFORM";
             WEB_EXECUTION_PLATFORM: "WEB_EXECUTION_PLATFORM";
             IOS_EXECUTION_PLATFORM: "IOS_EXECUTION_PLATFORM";
             ANDROID_EXECUTION_PLATFORM: "ANDROID_EXECUTION_PLATFORM";
-        }>, z.ZodTransform<"UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM", "web" | "ios" | "android" | "UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM">>>;
+        }>, z.ZodTransform<"UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM", "android" | "web" | "ios" | "UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM">>>;
         automationEmitsOnly: z.ZodOptional<z.ZodBoolean>;
         metadataFilters: z.ZodOptional<z.ZodArray<z.ZodObject<{
             key: z.ZodString;
@@ -987,14 +988,14 @@ export declare const getTruecoverageEventDetailsInput: z.ZodObject<{
         release: z.ZodOptional<z.ZodString>;
         branchName: z.ZodOptional<z.ZodString>;
         platform: z.ZodOptional<z.ZodPipe<z.ZodEnum<{
+            android: "android";
             web: "web";
             ios: "ios";
-            android: "android";
             UNKNOWN_EXECUTION_PLATFORM: "UNKNOWN_EXECUTION_PLATFORM";
             WEB_EXECUTION_PLATFORM: "WEB_EXECUTION_PLATFORM";
             IOS_EXECUTION_PLATFORM: "IOS_EXECUTION_PLATFORM";
             ANDROID_EXECUTION_PLATFORM: "ANDROID_EXECUTION_PLATFORM";
-        }>, z.ZodTransform<"UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM", "web" | "ios" | "android" | "UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM">>>;
+        }>, z.ZodTransform<"UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM", "android" | "web" | "ios" | "UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM">>>;
         automationEmitsOnly: z.ZodOptional<z.ZodBoolean>;
         metadataFilters: z.ZodOptional<z.ZodArray<z.ZodObject<{
             key: z.ZodString;
@@ -1029,14 +1030,14 @@ export declare const listTruecoverageChildEventTreeInput: z.ZodObject<{
         release: z.ZodOptional<z.ZodString>;
         branchName: z.ZodOptional<z.ZodString>;
         platform: z.ZodOptional<z.ZodPipe<z.ZodEnum<{
+            android: "android";
             web: "web";
             ios: "ios";
-            android: "android";
             UNKNOWN_EXECUTION_PLATFORM: "UNKNOWN_EXECUTION_PLATFORM";
             WEB_EXECUTION_PLATFORM: "WEB_EXECUTION_PLATFORM";
             IOS_EXECUTION_PLATFORM: "IOS_EXECUTION_PLATFORM";
             ANDROID_EXECUTION_PLATFORM: "ANDROID_EXECUTION_PLATFORM";
-        }>, z.ZodTransform<"UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM", "web" | "ios" | "android" | "UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM">>>;
+        }>, z.ZodTransform<"UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM", "android" | "web" | "ios" | "UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM">>>;
         automationEmitsOnly: z.ZodOptional<z.ZodBoolean>;
         metadataFilters: z.ZodOptional<z.ZodArray<z.ZodObject<{
             key: z.ZodString;
@@ -1068,14 +1069,14 @@ export declare const listTruecoverageChildEventTreeInput: z.ZodObject<{
         release: z.ZodOptional<z.ZodString>;
         branchName: z.ZodOptional<z.ZodString>;
         platform: z.ZodOptional<z.ZodPipe<z.ZodEnum<{
+            android: "android";
             web: "web";
             ios: "ios";
-            android: "android";
             UNKNOWN_EXECUTION_PLATFORM: "UNKNOWN_EXECUTION_PLATFORM";
             WEB_EXECUTION_PLATFORM: "WEB_EXECUTION_PLATFORM";
             IOS_EXECUTION_PLATFORM: "IOS_EXECUTION_PLATFORM";
             ANDROID_EXECUTION_PLATFORM: "ANDROID_EXECUTION_PLATFORM";
-        }>, z.ZodTransform<"UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM", "web" | "ios" | "android" | "UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM">>>;
+        }>, z.ZodTransform<"UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM", "android" | "web" | "ios" | "UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM">>>;
         automationEmitsOnly: z.ZodOptional<z.ZodBoolean>;
         metadataFilters: z.ZodOptional<z.ZodArray<z.ZodObject<{
             key: z.ZodString;
@@ -1111,14 +1112,14 @@ export declare const getTruecoverageEventTransitionInput: z.ZodObject<{
         release: z.ZodOptional<z.ZodString>;
         branchName: z.ZodOptional<z.ZodString>;
         platform: z.ZodOptional<z.ZodPipe<z.ZodEnum<{
+            android: "android";
             web: "web";
             ios: "ios";
-            android: "android";
             UNKNOWN_EXECUTION_PLATFORM: "UNKNOWN_EXECUTION_PLATFORM";
             WEB_EXECUTION_PLATFORM: "WEB_EXECUTION_PLATFORM";
             IOS_EXECUTION_PLATFORM: "IOS_EXECUTION_PLATFORM";
             ANDROID_EXECUTION_PLATFORM: "ANDROID_EXECUTION_PLATFORM";
-        }>, z.ZodTransform<"UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM", "web" | "ios" | "android" | "UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM">>>;
+        }>, z.ZodTransform<"UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM", "android" | "web" | "ios" | "UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM">>>;
         automationEmitsOnly: z.ZodOptional<z.ZodBoolean>;
         metadataFilters: z.ZodOptional<z.ZodArray<z.ZodObject<{
             key: z.ZodString;
@@ -1150,14 +1151,14 @@ export declare const getTruecoverageEventTransitionInput: z.ZodObject<{
         release: z.ZodOptional<z.ZodString>;
         branchName: z.ZodOptional<z.ZodString>;
         platform: z.ZodOptional<z.ZodPipe<z.ZodEnum<{
+            android: "android";
             web: "web";
             ios: "ios";
-            android: "android";
             UNKNOWN_EXECUTION_PLATFORM: "UNKNOWN_EXECUTION_PLATFORM";
             WEB_EXECUTION_PLATFORM: "WEB_EXECUTION_PLATFORM";
             IOS_EXECUTION_PLATFORM: "IOS_EXECUTION_PLATFORM";
             ANDROID_EXECUTION_PLATFORM: "ANDROID_EXECUTION_PLATFORM";
-        }>, z.ZodTransform<"UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM", "web" | "ios" | "android" | "UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM">>>;
+        }>, z.ZodTransform<"UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM", "android" | "web" | "ios" | "UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM">>>;
         automationEmitsOnly: z.ZodOptional<z.ZodBoolean>;
         metadataFilters: z.ZodOptional<z.ZodArray<z.ZodObject<{
             key: z.ZodString;
@@ -1204,14 +1205,14 @@ export declare const getTruecoverageEventTimeSeriesInput: z.ZodObject<{
         release: z.ZodOptional<z.ZodString>;
         branchName: z.ZodOptional<z.ZodString>;
         platform: z.ZodOptional<z.ZodPipe<z.ZodEnum<{
+            android: "android";
             web: "web";
             ios: "ios";
-            android: "android";
             UNKNOWN_EXECUTION_PLATFORM: "UNKNOWN_EXECUTION_PLATFORM";
             WEB_EXECUTION_PLATFORM: "WEB_EXECUTION_PLATFORM";
             IOS_EXECUTION_PLATFORM: "IOS_EXECUTION_PLATFORM";
             ANDROID_EXECUTION_PLATFORM: "ANDROID_EXECUTION_PLATFORM";
-        }>, z.ZodTransform<"UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM", "web" | "ios" | "android" | "UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM">>>;
+        }>, z.ZodTransform<"UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM", "android" | "web" | "ios" | "UNKNOWN_EXECUTION_PLATFORM" | "WEB_EXECUTION_PLATFORM" | "IOS_EXECUTION_PLATFORM" | "ANDROID_EXECUTION_PLATFORM">>>;
         automationEmitsOnly: z.ZodOptional<z.ZodBoolean>;
         metadataFilters: z.ZodOptional<z.ZodArray<z.ZodObject<{
             key: z.ZodString;
@@ -2007,3 +2008,71 @@ export declare const uploadAttachmentInput: z.ZodObject<{
 export declare const getBatchViewUrlInput: z.ZodObject<{
     batchInvocationId: z.ZodString;
 }, z.core.$strip>;
+export declare const botRoleSchema: z.ZodEnum<{
+    QA_LEAD: "QA_LEAD";
+    PM: "PM";
+    QA_ENGINEER: "QA_ENGINEER";
+    DEVELOPER: "DEVELOPER";
+}>;
+export declare const botCapabilitySchema: z.ZodEnum<{
+    REQUIREMENTS_UPDATE: "REQUIREMENTS_UPDATE";
+    E2E_AUTHORING: "E2E_AUTHORING";
+    ISSUE_FIX: "ISSUE_FIX";
+    MANUAL_TEST_COORDINATION: "MANUAL_TEST_COORDINATION";
+    TEST_BATCH_FIX: "TEST_BATCH_FIX";
+    QA_POSTURE: "QA_POSTURE";
+}>;
+export declare const botSubscriptionFilterSchema: z.ZodObject<{
+    field: z.ZodString;
+    op: z.ZodDefault<z.ZodLiteral<"eq">>;
+    value: z.ZodString;
+}, z.core.$strip>;
+export declare const botSubscriptionSchema: z.ZodObject<{
+    eventType: z.ZodString;
+    filters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        field: z.ZodString;
+        op: z.ZodDefault<z.ZodLiteral<"eq">>;
+        value: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const registerBotProfileInput: z.ZodObject<{
+    botId: z.ZodOptional<z.ZodString>;
+    role: z.ZodEnum<{
+        QA_LEAD: "QA_LEAD";
+        PM: "PM";
+        QA_ENGINEER: "QA_ENGINEER";
+        DEVELOPER: "DEVELOPER";
+    }>;
+    responsibilities: z.ZodOptional<z.ZodString>;
+    capabilities: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        REQUIREMENTS_UPDATE: "REQUIREMENTS_UPDATE";
+        E2E_AUTHORING: "E2E_AUTHORING";
+        ISSUE_FIX: "ISSUE_FIX";
+        MANUAL_TEST_COORDINATION: "MANUAL_TEST_COORDINATION";
+        TEST_BATCH_FIX: "TEST_BATCH_FIX";
+        QA_POSTURE: "QA_POSTURE";
+    }>>>;
+    subscriptions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        eventType: z.ZodString;
+        filters: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            op: z.ZodDefault<z.ZodLiteral<"eq">>;
+            value: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const getBotProfileInput: z.ZodObject<{
+    botId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const getMyTasksInput: z.ZodObject<{
+    userId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const listTestsAwaitingVerificationInput: z.ZodObject<{
+    userId: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const MAX_BOT_ACK_EVENT_IDS = 100;
+export declare const ackBotEventsInput: z.ZodObject<{
+    eventIds: z.ZodArray<z.ZodString>;
+    ackUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;

package/dist/core/schemas.js

@@ -323,6 +323,10 @@ export const updateGitFolderMappingInput = z.object({
     testsFolderPath: z.string().min(1).optional(),
     plansFolderPath: z.string().min(1).optional(),
     repositoryFullName: z.string().optional(),
+    plansBranch: z
+        .string()
+        .optional()
+        .describe("Branch plans sync against. Empty string resets to the repository default branch."),
     tests_folder_path: z.string().min(1).optional(),
     plans_folder_path: z.string().min(1).optional(),
     repository_full_name: z.string().optional(),
@@ -1040,3 +1044,52 @@ export const uploadAttachmentInput = z.object({
 export const getBatchViewUrlInput = z.object({
     batchInvocationId: z.string().min(1),
 });
+export const botRoleSchema = z.enum(["QA_LEAD", "PM", "QA_ENGINEER", "DEVELOPER"]);
+export const botCapabilitySchema = z.enum([
+    "REQUIREMENTS_UPDATE",
+    "E2E_AUTHORING",
+    "ISSUE_FIX",
+    "MANUAL_TEST_COORDINATION",
+    "TEST_BATCH_FIX",
+    "QA_POSTURE",
+]);
+export const botSubscriptionFilterSchema = z.object({
+    /** Payload filter field, e.g. author / assignee / adder. */
+    field: z.string().min(1),
+    op: z.literal("eq").default("eq"),
+    /** Literal value, or the token `me` (resolved to the bot's user). */
+    value: z.string().min(1),
+});
+export const botSubscriptionSchema = z.object({
+    /** Wire event type, e.g. git-push, issue-assigned, e2e-batch-completed. */
+    eventType: z.string().min(1),
+    filters: z.array(botSubscriptionFilterSchema).optional(),
+});
+export const registerBotProfileInput = z.object({
+    /** Defaults to the bot-id header (TESTCHIMP_BOT_ID) or the OAuth token's bot. */
+    botId: z.string().min(1).max(64).optional(),
+    role: botRoleSchema,
+    responsibilities: z.string().optional(),
+    capabilities: z.array(botCapabilitySchema).default([]),
+    subscriptions: z.array(botSubscriptionSchema).default([]),
+});
+export const getBotProfileInput = z.object({
+    botId: z.string().min(1).max(64).optional(),
+});
+export const getMyTasksInput = z.object({
+    /** Required with an API key; ignored with an OAuth token (the token's user is used). */
+    userId: z.string().min(1).optional(),
+});
+export const listTestsAwaitingVerificationInput = z.object({
+    userId: z.string().min(1).optional(),
+    limit: z.number().int().positive().max(500).optional(),
+});
+export const MAX_BOT_ACK_EVENT_IDS = 100;
+export const ackBotEventsInput = z.object({
+    eventIds: z
+        .array(z.string().regex(/^[\x20-\x7e]+$/, "eventIds must be printable ASCII").min(1))
+        .min(1)
+        .max(MAX_BOT_ACK_EVENT_IDS),
+    /** Webhook delivery ackUrl; defaults to ${TESTCHIMP_INGRESS_URL}/bot/events/ack. */
+    ackUrl: z.string().min(1).optional(),
+});

package/dist/core/tools.d.ts

@@ -1,10 +1,14 @@
 import { type ZodTypeAny } from "zod";
-import type { PostMcpFn } from "./client.js";
+import { type PostIngressFn, type PostMcpFn } from "./client.js";
 import { type ProgressLog } from "./ephemeralWait.js";
 export interface ToolContext {
     postMcp: PostMcpFn;
+    /** Ingress poster (bot acks); defaults to the env-configured ingress client. */
+    postIngress?: PostIngressFn;
     onProgress?: ProgressLog;
 }
+export declare const BOT_ACK_PATH = "/bot/events/ack";
+export declare const BOT_ACK_UNSUPPORTED_MESSAGE: string;
 export interface ToolDefinition {
     kebab: string;
     description: string;