@bugbug-io/api-schema 13.39.1

package/dist/schemas/runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../src/schemas/runs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,YAAY,EAAqB,MAAM,SAAS,CAAC;AAG1D,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;gCASZ,CAAC;AAEjB,eAAO,MAAM,uBAAuB;;;;;;;;;;;;gCAQpB,CAAC;AAEjB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCA8BV,CAAC;AAEjB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;gCAUf,CAAC;AAEjB,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAOrB,CAAC;AAEjB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAqBX,CAAC;AAEjB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;gCAUhB,CAAC;AAEjB,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAOtB,CAAC;AAEjB,eAAO,MAAM,iBAAiB;;;;;;;;;EAG5B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/schemas/runs.js

@@ -0,0 +1,101 @@
+import { z } from 'zod';
+import { DateTimeSchema, UuidSchema } from './common';
+import { StatusSchema, TriggeredBySchema } from './enums';
+import { StepErrorCodeSchema } from './steps';
+export const RunResultSchema = z
+    .object({
+    id: UuidSchema.describe('Run UUID.'),
+    status: StatusSchema.describe('Current status of the run.'),
+    webappUrl: z.string().describe('BugBug web app URL for the run details page.'),
+    modified: DateTimeSchema.optional().describe('Last modification timestamp reported by the API.'),
+})
+    .passthrough();
+export const StepRunScreenshotSchema = z
+    .object({
+    id: UuidSchema.describe('Step run UUID.'),
+    stepId: UuidSchema.nullable().describe('Original step UUID associated with the screenshot, if available.'),
+    screenshotUrl: z.string().describe('Screenshot URL for the step run.'),
+})
+    .passthrough();
+export const TestRunSchema = z
+    .object({
+    id: UuidSchema.describe('Test run UUID.'),
+    name: z.string().min(1).describe('Test run name.'),
+    queued: DateTimeSchema.nullable().describe('Queue timestamp, if the run waited before execution.'),
+    status: StatusSchema.describe('Current status of the test run.'),
+    sequence: z.number().nullable().describe('Sequence number assigned by BugBug, if available.'),
+    webappUrl: z.string().describe('BugBug web app URL for the test run.'),
+    errorCode: StepErrorCodeSchema.nullable().describe('Structured BugBug error code for the test run, if any.'),
+    duration: z.string().nullable().describe('Execution duration reported by the API.'),
+    started: DateTimeSchema.nullable().describe('Run start timestamp, if available.'),
+    ended: DateTimeSchema.nullable().describe('Run end timestamp, if available.'),
+    stepsRuns: z
+        .string()
+        .describe('API reference or serialized value containing the step runs payload.'),
+    runProfileId: UuidSchema.nullable().describe('Run profile UUID used for this execution, if available.'),
+    testId: UuidSchema.nullable().describe('Original test UUID associated with this run, if available.'),
+    suiteRunId: UuidSchema.nullable().describe('Parent suite run UUID when the test run belongs to a suite run.'),
+    triggeredBy: TriggeredBySchema,
+})
+    .passthrough();
+export const TestRunStateSchema = z
+    .object({
+    id: UuidSchema.describe('Test run UUID.'),
+    modified: DateTimeSchema.describe('Last modification timestamp reported by the API.'),
+    status: StatusSchema.optional().describe('Current status of the test run.'),
+    webappUrl: z.string().describe('BugBug web app URL for the test run.'),
+    duration: z.string().nullable().optional().describe('Execution duration reported by the API.'),
+    started: DateTimeSchema.nullable().optional().describe('Run start timestamp, if available.'),
+    ended: DateTimeSchema.nullable().optional().describe('Run end timestamp, if available.'),
+})
+    .passthrough();
+export const TestRunScreenshotsSchema = z
+    .object({
+    id: UuidSchema.describe('Test run UUID.'),
+    stepsRuns: z
+        .array(StepRunScreenshotSchema)
+        .describe('Screenshots captured for step runs within the test run.'),
+})
+    .passthrough();
+export const SuiteRunSchema = z
+    .object({
+    id: UuidSchema.describe('Suite run UUID.'),
+    name: z.string().min(1).describe('Suite run name.'),
+    queued: DateTimeSchema.nullable().describe('Queue timestamp, if the suite run waited before execution.'),
+    status: StatusSchema.describe('Current status of the suite run.'),
+    sequence: z.number().nullable().describe('Sequence number assigned by BugBug, if available.'),
+    webappUrl: z.string().describe('BugBug web app URL for the suite run.'),
+    errorCode: StepErrorCodeSchema.nullable().describe('Structured BugBug error code for the suite run, if any.'),
+    duration: z.string().nullable().describe('Execution duration reported by the API.'),
+    started: DateTimeSchema.nullable().describe('Run start timestamp, if available.'),
+    ended: DateTimeSchema.nullable().describe('Run end timestamp, if available.'),
+    profileId: UuidSchema.describe('Run profile UUID used for the suite run.'),
+    profileName: z.string().describe('Run profile name used for the suite run.'),
+    testRuns: z.array(TestRunSchema).describe('Test runs included in the suite run.'),
+    triggeredBy: TriggeredBySchema,
+})
+    .passthrough();
+export const SuiteRunStateSchema = z
+    .object({
+    id: UuidSchema.describe('Suite run UUID.'),
+    modified: DateTimeSchema.describe('Last modification timestamp reported by the API.'),
+    status: StatusSchema.describe('Current status of the suite run.'),
+    webappUrl: z.string().describe('BugBug web app URL for the suite run.'),
+    duration: z.string().nullable().optional().describe('Execution duration reported by the API.'),
+    started: DateTimeSchema.nullable().optional().describe('Run start timestamp, if available.'),
+    ended: DateTimeSchema.nullable().optional().describe('Run end timestamp, if available.'),
+})
+    .passthrough();
+export const SuiteRunScreenshotsSchema = z
+    .object({
+    id: UuidSchema.describe('Suite run UUID.'),
+    testsRuns: z
+        .array(TestRunScreenshotsSchema)
+        .describe('Screenshot collections grouped by test run within the suite run.'),
+})
+    .passthrough();
+export const RunVariableSchema = z.object({
+    key: z.string().describe('Variable name.'),
+    value: z.string().nullable().optional().describe('Variable value.'),
+});
+//# sourceMappingURL=runs.js.map

package/dist/schemas/runs.js.map

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

package/dist/schemas/selectors.d.ts

@@ -0,0 +1,308 @@
+/**
+ * Selector / selectors-group / selectors-preset schemas.
+ *
+ * Used by step schemas (`selectorsPresets`) and exposed to MCP as JSON Schema resources
+ * so that LLMs can author selectors directly.
+ */
+import { z } from 'zod';
+export declare const SelectorSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    selector: z.ZodNullable<z.ZodString>;
+    type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+    isActive: z.ZodBoolean;
+    step: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodOptional<z.ZodString>;
+    selector: z.ZodNullable<z.ZodString>;
+    type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+    isActive: z.ZodBoolean;
+    step: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodOptional<z.ZodString>;
+    selector: z.ZodNullable<z.ZodString>;
+    type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+    isActive: z.ZodBoolean;
+    step: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+export declare const SelectorsGroupSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    relation: z.ZodEnum<["descendant", "ancestor", "sibling"]>;
+    selectors: z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        selector: z.ZodNullable<z.ZodString>;
+        type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+        isActive: z.ZodBoolean;
+        step: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodOptional<z.ZodString>;
+        selector: z.ZodNullable<z.ZodString>;
+        type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+        isActive: z.ZodBoolean;
+        step: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodOptional<z.ZodString>;
+        selector: z.ZodNullable<z.ZodString>;
+        type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+        isActive: z.ZodBoolean;
+        step: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>, "many">;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodOptional<z.ZodString>;
+    relation: z.ZodEnum<["descendant", "ancestor", "sibling"]>;
+    selectors: z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        selector: z.ZodNullable<z.ZodString>;
+        type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+        isActive: z.ZodBoolean;
+        step: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodOptional<z.ZodString>;
+        selector: z.ZodNullable<z.ZodString>;
+        type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+        isActive: z.ZodBoolean;
+        step: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodOptional<z.ZodString>;
+        selector: z.ZodNullable<z.ZodString>;
+        type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+        isActive: z.ZodBoolean;
+        step: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>, "many">;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodOptional<z.ZodString>;
+    relation: z.ZodEnum<["descendant", "ancestor", "sibling"]>;
+    selectors: z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        selector: z.ZodNullable<z.ZodString>;
+        type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+        isActive: z.ZodBoolean;
+        step: z.ZodOptional<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodOptional<z.ZodString>;
+        selector: z.ZodNullable<z.ZodString>;
+        type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+        isActive: z.ZodBoolean;
+        step: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodOptional<z.ZodString>;
+        selector: z.ZodNullable<z.ZodString>;
+        type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+        isActive: z.ZodBoolean;
+        step: z.ZodOptional<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>, "many">;
+}, z.ZodTypeAny, "passthrough">>;
+export declare const SelectorsPresetSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    isCustom: z.ZodBoolean;
+    isActive: z.ZodBoolean;
+    selectorsGroups: z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        relation: z.ZodEnum<["descendant", "ancestor", "sibling"]>;
+        selectors: z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            selector: z.ZodNullable<z.ZodString>;
+            type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+            isActive: z.ZodBoolean;
+            step: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            id: z.ZodOptional<z.ZodString>;
+            selector: z.ZodNullable<z.ZodString>;
+            type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+            isActive: z.ZodBoolean;
+            step: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            id: z.ZodOptional<z.ZodString>;
+            selector: z.ZodNullable<z.ZodString>;
+            type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+            isActive: z.ZodBoolean;
+            step: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>, "many">;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodOptional<z.ZodString>;
+        relation: z.ZodEnum<["descendant", "ancestor", "sibling"]>;
+        selectors: z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            selector: z.ZodNullable<z.ZodString>;
+            type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+            isActive: z.ZodBoolean;
+            step: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            id: z.ZodOptional<z.ZodString>;
+            selector: z.ZodNullable<z.ZodString>;
+            type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+            isActive: z.ZodBoolean;
+            step: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            id: z.ZodOptional<z.ZodString>;
+            selector: z.ZodNullable<z.ZodString>;
+            type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+            isActive: z.ZodBoolean;
+            step: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>, "many">;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodOptional<z.ZodString>;
+        relation: z.ZodEnum<["descendant", "ancestor", "sibling"]>;
+        selectors: z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            selector: z.ZodNullable<z.ZodString>;
+            type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+            isActive: z.ZodBoolean;
+            step: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            id: z.ZodOptional<z.ZodString>;
+            selector: z.ZodNullable<z.ZodString>;
+            type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+            isActive: z.ZodBoolean;
+            step: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            id: z.ZodOptional<z.ZodString>;
+            selector: z.ZodNullable<z.ZodString>;
+            type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+            isActive: z.ZodBoolean;
+            step: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>, "many">;
+    }, z.ZodTypeAny, "passthrough">>, "many">;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodOptional<z.ZodString>;
+    isCustom: z.ZodBoolean;
+    isActive: z.ZodBoolean;
+    selectorsGroups: z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        relation: z.ZodEnum<["descendant", "ancestor", "sibling"]>;
+        selectors: z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            selector: z.ZodNullable<z.ZodString>;
+            type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+            isActive: z.ZodBoolean;
+            step: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            id: z.ZodOptional<z.ZodString>;
+            selector: z.ZodNullable<z.ZodString>;
+            type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+            isActive: z.ZodBoolean;
+            step: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            id: z.ZodOptional<z.ZodString>;
+            selector: z.ZodNullable<z.ZodString>;
+            type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+            isActive: z.ZodBoolean;
+            step: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>, "many">;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodOptional<z.ZodString>;
+        relation: z.ZodEnum<["descendant", "ancestor", "sibling"]>;
+        selectors: z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            selector: z.ZodNullable<z.ZodString>;
+            type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+            isActive: z.ZodBoolean;
+            step: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            id: z.ZodOptional<z.ZodString>;
+            selector: z.ZodNullable<z.ZodString>;
+            type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+            isActive: z.ZodBoolean;
+            step: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            id: z.ZodOptional<z.ZodString>;
+            selector: z.ZodNullable<z.ZodString>;
+            type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+            isActive: z.ZodBoolean;
+            step: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>, "many">;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodOptional<z.ZodString>;
+        relation: z.ZodEnum<["descendant", "ancestor", "sibling"]>;
+        selectors: z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            selector: z.ZodNullable<z.ZodString>;
+            type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+            isActive: z.ZodBoolean;
+            step: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            id: z.ZodOptional<z.ZodString>;
+            selector: z.ZodNullable<z.ZodString>;
+            type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+            isActive: z.ZodBoolean;
+            step: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            id: z.ZodOptional<z.ZodString>;
+            selector: z.ZodNullable<z.ZodString>;
+            type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+            isActive: z.ZodBoolean;
+            step: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>, "many">;
+    }, z.ZodTypeAny, "passthrough">>, "many">;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodOptional<z.ZodString>;
+    isCustom: z.ZodBoolean;
+    isActive: z.ZodBoolean;
+    selectorsGroups: z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        relation: z.ZodEnum<["descendant", "ancestor", "sibling"]>;
+        selectors: z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            selector: z.ZodNullable<z.ZodString>;
+            type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+            isActive: z.ZodBoolean;
+            step: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            id: z.ZodOptional<z.ZodString>;
+            selector: z.ZodNullable<z.ZodString>;
+            type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+            isActive: z.ZodBoolean;
+            step: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            id: z.ZodOptional<z.ZodString>;
+            selector: z.ZodNullable<z.ZodString>;
+            type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+            isActive: z.ZodBoolean;
+            step: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>, "many">;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodOptional<z.ZodString>;
+        relation: z.ZodEnum<["descendant", "ancestor", "sibling"]>;
+        selectors: z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            selector: z.ZodNullable<z.ZodString>;
+            type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+            isActive: z.ZodBoolean;
+            step: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            id: z.ZodOptional<z.ZodString>;
+            selector: z.ZodNullable<z.ZodString>;
+            type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+            isActive: z.ZodBoolean;
+            step: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            id: z.ZodOptional<z.ZodString>;
+            selector: z.ZodNullable<z.ZodString>;
+            type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+            isActive: z.ZodBoolean;
+            step: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>, "many">;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodOptional<z.ZodString>;
+        relation: z.ZodEnum<["descendant", "ancestor", "sibling"]>;
+        selectors: z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            selector: z.ZodNullable<z.ZodString>;
+            type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+            isActive: z.ZodBoolean;
+            step: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            id: z.ZodOptional<z.ZodString>;
+            selector: z.ZodNullable<z.ZodString>;
+            type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+            isActive: z.ZodBoolean;
+            step: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            id: z.ZodOptional<z.ZodString>;
+            selector: z.ZodNullable<z.ZodString>;
+            type: z.ZodNullable<z.ZodEnum<["XPath", "customCSS", "customXPath", ""]>>;
+            isActive: z.ZodBoolean;
+            step: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>, "many">;
+    }, z.ZodTypeAny, "passthrough">>, "many">;
+}, z.ZodTypeAny, "passthrough">>;
+//# sourceMappingURL=selectors.d.ts.map

package/dist/schemas/selectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.d.ts","sourceRoot":"","sources":["../../src/schemas/selectors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;gCAWX,CAAC;AAEjB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAWjB,CAAC;AAEjB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAYlB,CAAC"}

package/dist/schemas/selectors.js

@@ -0,0 +1,43 @@
+/**
+ * Selector / selectors-group / selectors-preset schemas.
+ *
+ * Used by step schemas (`selectorsPresets`) and exposed to MCP as JSON Schema resources
+ * so that LLMs can author selectors directly.
+ */
+import { z } from 'zod';
+import { UuidSchema } from './common';
+import { SelectorTypeSchema, SelectorsRelationSchema } from './enums';
+export const SelectorSchema = z
+    .object({
+    id: UuidSchema.optional().describe('Selector UUID when persisted by the API.'),
+    selector: z
+        .string()
+        .nullable()
+        .describe('Raw xpath or css selector expression used to find an element.'),
+    type: SelectorTypeSchema.describe('Selector engine or strategy name used by BugBug.'),
+    isActive: z.boolean().describe('Whether this selector is enabled.'),
+    step: UuidSchema.optional().describe('Owning step UUID when returned by the API.'),
+})
+    .passthrough();
+export const SelectorsGroupSchema = z
+    .object({
+    id: UuidSchema.optional().describe('Selectors group UUID when persisted by the API.'),
+    relation: SelectorsRelationSchema.describe('How selectors groups inside the preset are combined.'),
+    selectors: z
+        .array(SelectorSchema)
+        .min(1, 'Selectors group must contain at least one selector.')
+        .describe('Selectors included in this group. Must contain at least one selector.'),
+})
+    .passthrough();
+export const SelectorsPresetSchema = z
+    .object({
+    id: UuidSchema.optional().describe('Selectors preset UUID when persisted by the API.'),
+    isCustom: z.boolean().describe('Whether the preset was manually customized.'),
+    isActive: z.boolean().describe('Whether the preset is enabled for the step.'),
+    selectorsGroups: z
+        .array(SelectorsGroupSchema)
+        .min(1, 'Selectors preset must contain at least one selectors group.')
+        .describe('Selector groups used to locate the target element. Must contain at least one group when provided.'),
+})
+    .passthrough();
+//# sourceMappingURL=selectors.js.map

package/dist/schemas/selectors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.js","sourceRoot":"","sources":["../../src/schemas/selectors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAEtE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC5B,MAAM,CAAC;IACN,EAAE,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;IAC9E,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,+DAA+D,CAAC;IAC5E,IAAI,EAAE,kBAAkB,CAAC,QAAQ,CAAC,kDAAkD,CAAC;IACrF,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IACnE,IAAI,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;CACnF,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KAClC,MAAM,CAAC;IACN,EAAE,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;IACrF,QAAQ,EAAE,uBAAuB,CAAC,QAAQ,CACxC,sDAAsD,CACvD;IACD,SAAS,EAAE,CAAC;SACT,KAAK,CAAC,cAAc,CAAC;SACrB,GAAG,CAAC,CAAC,EAAE,qDAAqD,CAAC;SAC7D,QAAQ,CAAC,uEAAuE,CAAC;CACrF,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,MAAM,CAAC;IACN,EAAE,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;IACtF,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IAC7E,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IAC7E,eAAe,EAAE,CAAC;SACf,KAAK,CAAC,oBAAoB,CAAC;SAC3B,GAAG,CAAC,CAAC,EAAE,6DAA6D,CAAC;SACrE,QAAQ,CACP,mGAAmG,CACpG;CACJ,CAAC;KACD,WAAW,EAAE,CAAC"}