expect-sdk 0.0.24

package/dist/constants-DFJAD4-F.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants-DFJAD4-F.mjs","names":[],"sources":["../src/errors.ts","../src/build-instruction.ts","../src/layers.ts","../src/result-builder.ts","../src/constants.ts"],"sourcesContent":["import { Schema } from \"effect\";\n\nexport class ExpectTimeoutError extends Schema.ErrorClass<ExpectTimeoutError>(\"ExpectTimeoutError\")(\n  {\n    _tag: Schema.tag(\"ExpectTimeoutError\"),\n    timeoutMs: Schema.Number,\n  },\n) {\n  message = `expect execution timed out after ${this.timeoutMs}ms`;\n}\n\nexport class ExpectConfigError extends Error {\n  constructor(message: string, fix: string) {\n    super(`${message}\\n\\nFix: ${fix}`);\n    this.name = \"ExpectConfigError\";\n  }\n}\n","import { ExpectConfigError } from \"./errors\";\n\nexport const resolveUrl = (url: unknown, baseUrl: string | undefined): string => {\n  if (typeof url !== \"string\") {\n    throw new ExpectConfigError(\n      `Expected a URL string, got ${typeof url}.`,\n      `Expect.test({ url: \"http://localhost:3000/login\", tests: [...] })`,\n    );\n  }\n\n  try {\n    return new URL(url).href;\n  } catch {\n    /* relative URL — falls through to baseUrl resolution */\n  }\n\n  if (!baseUrl) {\n    throw new ExpectConfigError(\n      `No baseUrl configured and URL \"${url}\" is relative.`,\n      `configure({ baseUrl: \"http://localhost:3000\" })\\nOr use a full URL: Expect.test({ url: \"http://localhost:3000${url}\", tests: [...] })`,\n    );\n  }\n\n  return new URL(url, baseUrl).href;\n};\n\nexport const buildInstruction = (url: string, tests: readonly string[]): string => {\n  const lines = [`Navigate to ${url} and verify the following requirements:`, \"\"];\n\n  for (const [index, title] of tests.entries()) {\n    lines.push(`${index + 1}. ${title}`);\n  }\n\n  return lines.join(\"\\n\");\n};\n","import { Layer, References } from \"effect\";\nimport { Executor, Git } from \"@expect/supervisor\";\nimport { Agent, type AgentBackend } from \"@expect/agent\";\n\nexport const layerSdk = (agentBackend: AgentBackend, rootDir: string) => {\n  const gitLayer = Git.withRepoRoot(rootDir);\n  const agentLayer = Agent.layerFor(agentBackend);\n  const executorLayer = Executor.layer.pipe(Layer.provide(gitLayer));\n\n  return Layer.mergeAll(executorLayer, gitLayer).pipe(\n    Layer.provideMerge(agentLayer),\n    Layer.provideMerge(Layer.succeed(References.MinimumLogLevel, \"Error\")),\n  );\n};\n","import { DateTime, Option } from \"effect\";\nimport type { ExecutedTestPlan, TestPlanStep, ExecutionEvent } from \"@expect/shared/models\";\nimport type { Status, StepResult, TestResult, TestEvent } from \"./types\";\n\nconst REPLAY_SESSION_PREFIX = \"rrweb replay:\";\nconst SCREENSHOT_PREFIX = \"Screenshot:\";\n\nconst stepDurationMs = (step: TestPlanStep): number => {\n  if (Option.isNone(step.startedAt)) return 0;\n  if (Option.isNone(step.endedAt))\n    return Date.now() - Number(DateTime.toEpochMillis(step.startedAt.value));\n  return (\n    Number(DateTime.toEpochMillis(step.endedAt.value)) -\n    Number(DateTime.toEpochMillis(step.startedAt.value))\n  );\n};\n\nconst stepStatusToResultStatus = (status: string): Status => {\n  if (status === \"passed\") return \"passed\";\n  if (status === \"failed\" || status === \"skipped\") return \"failed\";\n  return \"pending\";\n};\n\nexport interface ExecutionArtifacts {\n  readonly recordingPath: string | undefined;\n  readonly screenshotPaths: readonly string[];\n}\n\nexport const extractArtifacts = (events: readonly ExecutionEvent[]): ExecutionArtifacts => {\n  const closeResult = events\n    .slice()\n    .reverse()\n    .find(\n      (event) =>\n        event._tag === \"ToolResult\" &&\n        event.toolName === \"close\" &&\n        !event.isError &&\n        event.result.length > 0,\n    );\n\n  if (!closeResult || closeResult._tag !== \"ToolResult\") {\n    return { recordingPath: undefined, screenshotPaths: [] };\n  }\n\n  const lines = closeResult.result\n    .split(\"\\n\")\n    .map((line) => line.trim())\n    .filter((line) => line.length > 0);\n\n  const replayLine = lines.find((line) => line.startsWith(REPLAY_SESSION_PREFIX));\n  const recordingPath = replayLine?.replace(REPLAY_SESSION_PREFIX, \"\").trim() || undefined;\n\n  const screenshotPaths = lines\n    .filter((line) => line.startsWith(SCREENSHOT_PREFIX))\n    .map((line) => line.replace(SCREENSHOT_PREFIX, \"\").trim())\n    .filter((value) => value.length > 0);\n\n  return { recordingPath, screenshotPaths };\n};\n\nexport const buildStepResult = (\n  step: TestPlanStep,\n  screenshotPaths: readonly string[],\n  stepIndex: number,\n): StepResult => ({\n  title: step.title,\n  status: stepStatusToResultStatus(step.status),\n  summary: Option.getOrElse(step.summary, () => \"\"),\n  screenshotPath: screenshotPaths[stepIndex],\n  duration: stepDurationMs(step),\n});\n\nexport const buildTestResult = (\n  executed: ExecutedTestPlan,\n  url: string,\n  startedAt: number,\n  artifacts: ExecutionArtifacts,\n): TestResult => {\n  const steps = executed.steps.map((step, index) =>\n    buildStepResult(step, artifacts.screenshotPaths, index),\n  );\n  const errors = steps.filter((step) => step.status === \"failed\");\n  const hasFailure = errors.length > 0;\n  const hasPending = steps.some((step) => step.status === \"pending\");\n\n  let status: Status = \"passed\";\n  if (hasFailure) status = \"failed\";\n  else if (hasPending || steps.length === 0) status = \"pending\";\n\n  return {\n    status,\n    url,\n    duration: Date.now() - startedAt,\n    recordingPath: artifacts.recordingPath,\n    steps,\n    errors,\n  };\n};\n\ninterface DiffContext {\n  readonly stepMap: ReadonlyMap<string, TestPlanStep>;\n  readonly stepIndexMap: ReadonlyMap<string, number>;\n  readonly artifacts: ExecutionArtifacts;\n  readonly executed: ExecutedTestPlan;\n  readonly url: string;\n  readonly startedAt: number;\n}\n\nconst mapExecutionEvent = (event: ExecutionEvent, context: DiffContext): TestEvent | undefined => {\n  switch (event._tag) {\n    case \"RunStarted\":\n      return {\n        type: \"run:started\",\n        title: event.plan.title,\n        baseUrl: Option.getOrUndefined(event.plan.baseUrl),\n      };\n    case \"StepStarted\":\n      return { type: \"step:started\", title: event.title };\n    case \"StepCompleted\": {\n      const step = context.stepMap.get(event.stepId);\n      const index = context.stepIndexMap.get(event.stepId) ?? -1;\n      return step\n        ? {\n            type: \"step:passed\",\n            step: buildStepResult(step, context.artifacts.screenshotPaths, index),\n          }\n        : undefined;\n    }\n    case \"StepFailed\": {\n      const step = context.stepMap.get(event.stepId);\n      const index = context.stepIndexMap.get(event.stepId) ?? -1;\n      return step\n        ? {\n            type: \"step:failed\",\n            step: buildStepResult(step, context.artifacts.screenshotPaths, index),\n          }\n        : undefined;\n    }\n    case \"StepSkipped\":\n      return {\n        type: \"step:skipped\",\n        title: context.stepMap.get(event.stepId)?.title ?? event.stepId,\n        reason: event.reason,\n      };\n    case \"ToolResult\":\n      return event.toolName.endsWith(\"__screenshot\") && !event.isError\n        ? { type: \"screenshot\", title: event.toolName, path: event.result }\n        : undefined;\n    case \"RunFinished\":\n      return {\n        type: \"completed\",\n        result: buildTestResult(\n          context.executed,\n          context.url,\n          context.startedAt,\n          context.artifacts,\n        ),\n      };\n    default:\n      return undefined;\n  }\n};\n\nexport const diffEvents = (\n  previous: readonly ExecutionEvent[],\n  current: readonly ExecutionEvent[],\n  executed: ExecutedTestPlan,\n  url: string,\n  startedAt: number,\n): TestEvent[] => {\n  const context: DiffContext = {\n    stepMap: new Map(executed.steps.map((step) => [step.id, step])),\n    stepIndexMap: new Map(executed.steps.map((step, index) => [step.id, index])),\n    artifacts: extractArtifacts(executed.events),\n    executed,\n    url,\n    startedAt,\n  };\n\n  return current\n    .slice(previous.length)\n    .map((event) => mapExecutionEvent(event, context))\n    .filter((event): event is TestEvent => event !== undefined);\n};\n","export const DEFAULT_TIMEOUT_MS = 5 * 60 * 1000;\nexport const DEFAULT_AGENT_BACKEND = \"claude\" as const;\n"],"mappings":"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"}

package/dist/effect.d.mts

@@ -0,0 +1,30 @@
+import { _ as DEFAULT_AGENT_BACKEND, b as ExpectTimeoutError, f as TestEvent, i as CookieInput, m as TestResult, n as BrowserName, r as Cookie, t as Action, u as StepResult, v as DEFAULT_TIMEOUT_MS, y as ExpectConfigError } from "./types-0J0EwTM4.mjs";
+import { Layer } from "effect";
+import * as _expect_supervisor0 from "@expect/supervisor";
+import { Executor, Git } from "@expect/supervisor";
+import { ExecutedTestPlan, ExecutionEvent, TestPlanStep } from "@expect/shared/models";
+import * as _expect_agent0 from "@expect/agent";
+import { Agent, AgentBackend } from "@expect/agent";
+import * as effect_PlatformError0 from "effect/PlatformError";
+import * as effect_Config0 from "effect/Config";
+import * as effect_Schema0 from "effect/Schema";
+
+//#region src/build-instruction.d.ts
+declare const resolveUrl: (url: unknown, baseUrl: string | undefined) => string;
+declare const buildInstruction: (url: string, tests: readonly string[]) => string;
+//#endregion
+//#region src/layers.d.ts
+declare const layerSdk: (agentBackend: AgentBackend, rootDir: string) => Layer.Layer<Executor | Agent | Git | _expect_supervisor0.GitRepoRoot, _expect_supervisor0.FindRepoRootError | (_expect_agent0.AcpProviderUnauthenticatedError | effect_PlatformError0.PlatformError | effect_Config0.ConfigError | effect_Schema0.SchemaError | _expect_agent0.AcpProviderNotInstalledError | _expect_agent0.AcpConnectionInitError | _expect_agent0.AcpAdapterNotFoundError), never>;
+//#endregion
+//#region src/result-builder.d.ts
+interface ExecutionArtifacts {
+  readonly recordingPath: string | undefined;
+  readonly screenshotPaths: readonly string[];
+}
+declare const extractArtifacts: (events: readonly ExecutionEvent[]) => ExecutionArtifacts;
+declare const buildStepResult: (step: TestPlanStep, screenshotPaths: readonly string[], stepIndex: number) => StepResult;
+declare const buildTestResult: (executed: ExecutedTestPlan, url: string, startedAt: number, artifacts: ExecutionArtifacts) => TestResult;
+declare const diffEvents: (previous: readonly ExecutionEvent[], current: readonly ExecutionEvent[], executed: ExecutedTestPlan, url: string, startedAt: number) => TestEvent[];
+//#endregion
+export { type Action, type BrowserName, type Cookie, type CookieInput, DEFAULT_AGENT_BACKEND, DEFAULT_TIMEOUT_MS, ExpectConfigError, ExpectTimeoutError, type StepResult, type TestEvent, type TestResult, buildInstruction, buildStepResult, buildTestResult, diffEvents, extractArtifacts, layerSdk, resolveUrl };
+//# sourceMappingURL=effect.d.mts.map

package/dist/effect.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect.d.mts","names":[],"sources":["../src/build-instruction.ts","../src/layers.ts","../src/result-builder.ts"],"mappings":";;;;;;;;;;;;cAEa,UAAA,GAAc,GAAA,WAAc,OAAA;AAAA,cAwB5B,gBAAA,GAAoB,GAAA,UAAa,KAAA;;;cCtBjC,QAAA,GAAY,YAAA,EAAc,YAAA,EAAc,OAAA,aAAe,KAAA,CAAA,KAAA,CAAA,QAAA,GAAA,KAAA,GAAA,GAAA,GAAA,mBAAA,CAAA,WAAA,EAAA,mBAAA,CAAA,iBAAA,IAAA,cAAA,CAAA,+BAAA,GAAA,qBAAA,CAAA,aAAA,GAAA,cAAA,CAAA,WAAA,GAAA,cAAA,CAAA,WAAA,GAAA,cAAA,CAAA,4BAAA,GAAA,cAAA,CAAA,sBAAA,GAAA,cAAA,CAAA,uBAAA;;;UCmBnD,kBAAA;EAAA,SACN,aAAA;EAAA,SACA,eAAA;AAAA;AAAA,cAGE,gBAAA,GAAoB,MAAA,WAAiB,cAAA,OAAmB,kBAAA;AAAA,cAgCxD,eAAA,GACX,IAAA,EAAM,YAAA,EACN,eAAA,qBACA,SAAA,aACC,UAAA;AAAA,cAQU,eAAA,GACX,QAAA,EAAU,gBAAA,EACV,GAAA,UACA,SAAA,UACA,SAAA,EAAW,kBAAA,KACV,UAAA;AAAA,cAsFU,UAAA,GACX,QAAA,WAAmB,cAAA,IACnB,OAAA,WAAkB,cAAA,IAClB,QAAA,EAAU,gBAAA,EACV,GAAA,UACA,SAAA,aACC,SAAA"}

package/dist/effect.mjs

@@ -0,0 +1,2 @@
+import { a as diffEvents, c as buildInstruction, d as ExpectTimeoutError, i as buildTestResult, l as resolveUrl, n as DEFAULT_TIMEOUT_MS, o as extractArtifacts, r as buildStepResult, s as layerSdk, t as DEFAULT_AGENT_BACKEND, u as ExpectConfigError } from "./constants-DFJAD4-F.mjs";
+export { DEFAULT_AGENT_BACKEND, DEFAULT_TIMEOUT_MS, ExpectConfigError, ExpectTimeoutError, buildInstruction, buildStepResult, buildTestResult, diffEvents, extractArtifacts, layerSdk, resolveUrl };

package/dist/index.d.mts

@@ -0,0 +1,20 @@
+import { a as ExpectConfig, c as SessionTestInput, d as Test, f as TestEvent, g as Tool, h as TestRun, i as CookieInput, l as Status, m as TestResult, n as BrowserName, o as ExpectSession, p as TestInput, r as Cookie, s as SessionConfig, t as Action, u as StepResult, v as DEFAULT_TIMEOUT_MS, y as ExpectConfigError } from "./types-0J0EwTM4.mjs";
+import { StandardJSONSchemaV1 } from "@standard-schema/spec";
+
+//#region src/expect.d.ts
+declare const Expect: {
+  readonly test: (input: TestInput) => TestRun;
+  readonly session: (config: SessionConfig) => ExpectSession;
+  readonly cookies: (browser: true | BrowserName | BrowserName[]) => Promise<Cookie[]>;
+};
+//#endregion
+//#region src/tool.d.ts
+type SchemaInput = StandardJSONSchemaV1 | Record<string, unknown>;
+declare const tool: (name: string, description: string, schema: SchemaInput, handler: (input: Record<string, unknown>) => Promise<string>) => Tool;
+//#endregion
+//#region src/config.d.ts
+declare const defineConfig: (config: ExpectConfig) => ExpectConfig;
+declare const configure: (config: Partial<ExpectConfig>) => void;
+//#endregion
+export { type Action, type BrowserName, type Cookie, type CookieInput, DEFAULT_TIMEOUT_MS, Expect, Expect as default, type ExpectConfig, ExpectConfigError, type ExpectSession, type SessionConfig, type SessionTestInput, type Status, type StepResult, type Test, type TestEvent, type TestInput, type TestResult, type TestRun, type Tool, configure, defineConfig, tool };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/expect.ts","../src/tool.ts","../src/config.ts"],"mappings":";;;;cA+aa,MAAA;EAAA,uBAjEQ,SAAA,KAAY,OAAA;EAAA,2BAOR,aAAA,KAAgB,aAAA;EAAA,mCA6CR,WAAA,GAAc,WAAA,OAAgB,OAAA,CAAQ,MAAA;AAAA;;;KC/ZlE,WAAA,GAAc,oBAAA,GAAuB,MAAA;AAAA,cAY7B,IAAA,GACX,IAAA,UACA,WAAA,UACA,MAAA,EAAQ,WAAA,EACR,OAAA,GAAU,KAAA,EAAO,MAAA,sBAA4B,OAAA,aAC5C,IAAA;;;cChBU,YAAA,GAAgB,MAAA,EAAQ,YAAA,KAAe,YAAA;AAAA,cAEvC,SAAA,GAAa,MAAA,EAAQ,OAAA,CAAQ,YAAA"}

package/dist/index.mjs

@@ -0,0 +1,279 @@
+import { a as diffEvents, c as buildInstruction, d as ExpectTimeoutError, i as buildTestResult, l as resolveUrl, n as DEFAULT_TIMEOUT_MS, o as extractArtifacts, s as layerSdk, t as DEFAULT_AGENT_BACKEND, u as ExpectConfigError } from "./constants-DFJAD4-F.mjs";
+import { Effect, Option, Stream } from "effect";
+import * as NodeServices from "@effect/platform-node/NodeServices";
+import { Executor } from "@expect/supervisor";
+import { ChangesFor } from "@expect/shared/models";
+import { Browsers, Cookies, layerLive } from "@expect/cookies";
+//#region src/config.ts
+let globalConfig = {};
+const defineConfig = (config) => config;
+const configure = (config) => {
+	globalConfig = {
+		...globalConfig,
+		...config
+	};
+};
+const getGlobalConfig = () => globalConfig;
+//#endregion
+//#region src/test-run.ts
+const createTestRun = (callbacks) => ({
+	then(onfulfilled, onrejected) {
+		return callbacks.promise.then(onfulfilled, onrejected);
+	},
+	[Symbol.asyncIterator]() {
+		return callbacks.subscribe();
+	}
+});
+//#endregion
+//#region src/expect.ts
+const normalizeTestPrompts = (tests) => tests.map((test) => typeof test === "string" ? test : test.prompt);
+const resolveInputUrl = (input) => {
+	const config = getGlobalConfig();
+	if (input.page) return input.page.url();
+	if (input.url !== void 0) return resolveUrl(input.url, config.baseUrl);
+	if (config.baseUrl) return config.baseUrl;
+	throw new ExpectConfigError("No URL provided and no baseUrl configured.", `Expect.test({ url: "http://localhost:3000", tests: [...] })\nOr: configure({ baseUrl: "http://localhost:3000" })`);
+};
+const validateTests = (tests) => {
+	if (tests.length === 0) throw new ExpectConfigError("tests array is empty.", `Expect.test({ url: "...", tests: ["at least one test"] })`);
+};
+const validateTestInput = (input) => {
+	validateTests(input.tests);
+	if (input.tools && input.tools.length > 0) throw new ExpectConfigError("Custom tools are not yet supported.", `Remove the tools field for now. Tool support is coming in a future release.`);
+	if (typeof input.before === "function" && !input.page) throw new ExpectConfigError("Function before requires a page.", `Pass a Playwright Page: Expect.test({ page, before: async (page) => { ... }, tests: [...] })`);
+	if (typeof input.after === "function" && !input.page) throw new ExpectConfigError("Function after requires a page.", `Pass a Playwright Page: Expect.test({ page, after: async (page) => { ... }, tests: [...] })`);
+};
+const validateSessionConfig = (config) => {
+	if (config.browserContext) throw new ExpectConfigError("External browserContext is not yet supported.", `Remove the browserContext field. The SDK manages browser lifecycle internally.`);
+	if (config.tools && config.tools.length > 0) throw new ExpectConfigError("Custom tools are not yet supported.", `Remove the tools field for now. Tool support is coming in a future release.`);
+};
+const isBrowserNameArray = (cookies) => cookies.length > 0 && typeof cookies[0] === "string";
+const resolveCookies = (cookies) => {
+	if (cookies === void 0) return {
+		browserKeys: [],
+		explicitCookies: []
+	};
+	if (cookies === true) return {
+		browserKeys: ["chrome"],
+		explicitCookies: []
+	};
+	if (typeof cookies === "string") return {
+		browserKeys: [cookies],
+		explicitCookies: []
+	};
+	if (Array.isArray(cookies)) {
+		if (isBrowserNameArray(cookies)) return {
+			browserKeys: cookies,
+			explicitCookies: []
+		};
+		return {
+			browserKeys: [],
+			explicitCookies: cookies
+		};
+	}
+	return {
+		browserKeys: [],
+		explicitCookies: []
+	};
+};
+const buildInstructionWithActions = (url, tests, before, beforeContext, after) => {
+	let instruction = buildInstruction(url, normalizeTestPrompts(tests));
+	if (typeof before === "string") instruction = `Before: ${before}\n\n${instruction}`;
+	if (beforeContext) instruction = `Context from before: ${beforeContext}\n\n${instruction}`;
+	if (typeof after === "string") instruction = `${instruction}\n\nAfter: ${after}`;
+	return instruction;
+};
+const executeTests = Effect.fn("Sdk.executeTests")(function* (executeOptions, context) {
+	yield* Effect.annotateCurrentSpan({
+		url: context.url,
+		isHeadless: executeOptions.isHeadless
+	});
+	const executor = yield* Executor;
+	let previousEvents = [];
+	const finalExecuted = yield* executor.execute(executeOptions).pipe(Stream.tap((executed) => Effect.sync(() => {
+		const newEvents = diffEvents(previousEvents, executed.events, executed, context.url, context.startedAt);
+		previousEvents = executed.events;
+		for (const event of newEvents) context.eventBuffer.push(event);
+		context.resolveWaiter.current?.();
+	})), Stream.runLast, Effect.flatMap((option) => Option.match(option, {
+		onNone: () => Effect.fail(new ExpectTimeoutError({ timeoutMs: 0 })),
+		onSome: (executed) => Effect.succeed(executed.finalizeTextBlock().synthesizeRunFinished())
+	})));
+	const artifacts = extractArtifacts(finalExecuted.events);
+	const result = buildTestResult(finalExecuted, context.url, context.startedAt, artifacts);
+	if (!context.eventBuffer.some((event) => event.type === "completed")) context.eventBuffer.push({
+		type: "completed",
+		result
+	});
+	context.resolveWaiter.current?.();
+	return result;
+});
+const extractCookies = Effect.fn("Sdk.extractCookies")(function* (keys) {
+	yield* Effect.annotateCurrentSpan({ browserKeys: keys.join(",") });
+	const cookiesService = yield* Cookies;
+	const matchingBrowsers = (yield* (yield* Browsers).list).filter((browser) => keys.some((key) => {
+		if (browser._tag === "ChromiumBrowser") return browser.key === key;
+		if (browser._tag === "FirefoxBrowser") return key === "firefox";
+		if (browser._tag === "SafariBrowser") return key === "safari";
+		return false;
+	}));
+	return (yield* Effect.forEach(matchingBrowsers, (browser) => cookiesService.extract(browser), { concurrency: "unbounded" })).flat().map((cookie) => {
+		const formatted = cookie.playwrightFormat;
+		return {
+			...formatted,
+			sameSite: formatted.sameSite ?? "Lax"
+		};
+	});
+});
+const createAsyncIterator = (eventBuffer, resolveWaiter, getFinished, getError) => {
+	return () => {
+		let cursor = 0;
+		return {
+			async next() {
+				while (true) {
+					if (cursor < eventBuffer.length) {
+						const event = eventBuffer[cursor];
+						cursor++;
+						if (event.type === "completed") return {
+							done: true,
+							value: void 0
+						};
+						return {
+							done: false,
+							value: event
+						};
+					}
+					if (getFinished()) {
+						const error = getError();
+						if (error) throw error;
+						return {
+							done: true,
+							value: void 0
+						};
+					}
+					await new Promise((resolve) => {
+						resolveWaiter.current = resolve;
+					});
+				}
+			},
+			[Symbol.asyncIterator]() {
+				return this;
+			}
+		};
+	};
+};
+const runExecution = (url, tests, input) => {
+	const config = getGlobalConfig();
+	const timeoutMs = input.timeout ?? config.timeout ?? 3e5;
+	const isHeadless = (input.mode ?? config.mode ?? "headless") === "headless";
+	const resolved = resolveCookies(input.cookies ?? config.cookies);
+	const rootDir = config.rootDir ?? process.cwd();
+	const eventBuffer = [];
+	const resolveWaiter = { current: void 0 };
+	let finished = false;
+	let executionError;
+	const startExecution = async () => {
+		let beforeContext;
+		if (typeof input.before === "function" && input.page) {
+			const beforeResult = await input.before(input.page);
+			if (typeof beforeResult === "string") beforeContext = beforeResult;
+		}
+		const instruction = buildInstructionWithActions(url, tests, input.before, beforeContext, input.after);
+		const program = executeTests({
+			changesFor: ChangesFor.makeUnsafe({ _tag: "WorkingTree" }),
+			instruction,
+			isHeadless,
+			cookieBrowserKeys: [...resolved.browserKeys],
+			baseUrl: url
+		}, {
+			url,
+			startedAt: Date.now(),
+			eventBuffer,
+			resolveWaiter
+		}).pipe(Effect.timeoutOrElse({
+			duration: `${timeoutMs} millis`,
+			onTimeout: () => Effect.fail(new ExpectTimeoutError({ timeoutMs }))
+		}), Effect.provide(layerSdk(DEFAULT_AGENT_BACKEND, rootDir)), Effect.provide(NodeServices.layer));
+		const result = await Effect.runPromise(program);
+		if (typeof input.after === "function" && input.page) await input.after(input.page);
+		return result;
+	};
+	return {
+		promise: startExecution().then((result) => {
+			finished = true;
+			resolveWaiter.current?.();
+			return result;
+		}, (error) => {
+			executionError = error;
+			finished = true;
+			resolveWaiter.current?.();
+			throw error;
+		}),
+		subscribe: createAsyncIterator(eventBuffer, resolveWaiter, () => finished, () => executionError)
+	};
+};
+const test = (input) => {
+	validateTestInput(input);
+	const { promise, subscribe } = runExecution(resolveInputUrl(input), input.tests, input);
+	return createTestRun({
+		promise,
+		subscribe
+	});
+};
+const session = (config) => {
+	validateSessionConfig(config);
+	const sessionTest = (input) => {
+		validateTests(input.tests);
+		const testUrl = input.url ?? config.url;
+		const globalCfg = getGlobalConfig();
+		let resolvedUrl;
+		if (testUrl !== void 0) resolvedUrl = resolveUrl(testUrl, globalCfg.baseUrl ?? config.url);
+		else if (config.url) resolvedUrl = config.url;
+		else if (globalCfg.baseUrl) resolvedUrl = globalCfg.baseUrl;
+		else throw new ExpectConfigError("No URL provided for session test and no baseUrl configured.", `session.test({ url: "/page", tests: [...] })`);
+		const { promise, subscribe } = runExecution(resolvedUrl, input.tests, {
+			cookies: config.cookies,
+			mode: input.mode ?? config.mode,
+			timeout: input.timeout ?? config.timeout,
+			isRecording: input.isRecording ?? config.isRecording,
+			before: input.before,
+			after: input.after
+		});
+		return createTestRun({
+			promise,
+			subscribe
+		});
+	};
+	const close = async () => {};
+	return {
+		test: sessionTest,
+		close,
+		[Symbol.asyncDispose]: close
+	};
+};
+const cookies = (browser) => {
+	const keys = browser === true ? ["chrome"] : typeof browser === "string" ? [browser] : browser;
+	return Effect.runPromise(Effect.scoped(extractCookies(keys)).pipe(Effect.provide(Cookies.layer), Effect.provide(layerLive), Effect.provide(NodeServices.layer)));
+};
+const Expect = {
+	test,
+	session,
+	cookies
+};
+//#endregion
+//#region src/tool.ts
+const isStandardSchema = (schema) => "~standard" in schema && typeof schema["~standard"] === "object";
+const toInputSchema = (schema) => {
+	if (isStandardSchema(schema)) return schema["~standard"].jsonSchema.input({ target: "draft-07" });
+	return schema;
+};
+const tool = (name, description, schema, handler) => ({
+	name,
+	description,
+	inputSchema: toInputSchema(schema),
+	handler
+});
+//#endregion
+export { DEFAULT_TIMEOUT_MS, Expect, Expect as default, ExpectConfigError, configure, defineConfig, tool };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["CookiesService","cookiesLayerLive"],"sources":["../src/config.ts","../src/test-run.ts","../src/expect.ts","../src/tool.ts"],"sourcesContent":["import type { ExpectConfig } from \"./types\";\n\nlet globalConfig: ExpectConfig = {};\n\nexport const defineConfig = (config: ExpectConfig): ExpectConfig => config;\n\nexport const configure = (config: Partial<ExpectConfig>): void => {\n  globalConfig = { ...globalConfig, ...config };\n};\n\nexport const getGlobalConfig = (): ExpectConfig => globalConfig;\n\nexport const resetGlobalConfig = (): void => {\n  globalConfig = {};\n};\n","import type { TestResult, TestEvent, TestRun } from \"./types\";\n\ninterface TestRunCallbacks {\n  readonly promise: Promise<TestResult>;\n  readonly subscribe: () => AsyncIterableIterator<TestEvent>;\n}\n\nexport const createTestRun = (callbacks: TestRunCallbacks): TestRun => ({\n  then<TResult1 = TestResult, TResult2 = never>(\n    onfulfilled?: ((value: TestResult) => TResult1 | PromiseLike<TResult1>) | undefined | null,\n    onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | undefined | null,\n  ): PromiseLike<TResult1 | TResult2> {\n    return callbacks.promise.then(onfulfilled, onrejected);\n  },\n\n  [Symbol.asyncIterator](): AsyncIterator<TestEvent> {\n    return callbacks.subscribe();\n  },\n});\n","import { Effect, Option, Stream } from \"effect\";\nimport * as NodeServices from \"@effect/platform-node/NodeServices\";\nimport { Executor, type ExecuteOptions } from \"@expect/supervisor\";\nimport { type ExecutedTestPlan, type ExecutionEvent, ChangesFor } from \"@expect/shared/models\";\nimport {\n  Cookies as CookiesService,\n  Browsers,\n  layerLive as cookiesLayerLive,\n} from \"@expect/cookies\";\nimport { ExpectConfigError, ExpectTimeoutError } from \"./errors\";\nimport { resolveUrl, buildInstruction } from \"./build-instruction\";\nimport { getGlobalConfig } from \"./config\";\nimport { layerSdk } from \"./layers\";\nimport { createTestRun } from \"./test-run\";\nimport { buildTestResult, diffEvents, extractArtifacts } from \"./result-builder\";\nimport { DEFAULT_TIMEOUT_MS, DEFAULT_AGENT_BACKEND } from \"./constants\";\nimport type { Page } from \"playwright\";\nimport type {\n  TestInput,\n  TestRun,\n  TestResult,\n  TestEvent,\n  SessionConfig,\n  SessionTestInput,\n  ExpectSession,\n  Cookie,\n  BrowserName,\n  Test,\n} from \"./types\";\n\nconst normalizeTestPrompts = (tests: readonly Test[]): readonly string[] =>\n  tests.map((test) => (typeof test === \"string\" ? test : test.prompt));\n\nconst resolveInputUrl = (input: { url?: string; page?: Page }): string => {\n  const config = getGlobalConfig();\n\n  if (input.page) {\n    return input.page.url();\n  }\n\n  if (input.url !== undefined) {\n    return resolveUrl(input.url, config.baseUrl);\n  }\n\n  if (config.baseUrl) {\n    return config.baseUrl;\n  }\n\n  throw new ExpectConfigError(\n    \"No URL provided and no baseUrl configured.\",\n    `Expect.test({ url: \"http://localhost:3000\", tests: [...] })\\nOr: configure({ baseUrl: \"http://localhost:3000\" })`,\n  );\n};\n\nconst validateTests = (tests: readonly Test[]): void => {\n  if (tests.length === 0) {\n    throw new ExpectConfigError(\n      \"tests array is empty.\",\n      `Expect.test({ url: \"...\", tests: [\"at least one test\"] })`,\n    );\n  }\n};\n\nconst validateTestInput = (input: TestInput): void => {\n  validateTests(input.tests);\n  if (input.tools && input.tools.length > 0) {\n    throw new ExpectConfigError(\n      \"Custom tools are not yet supported.\",\n      `Remove the tools field for now. Tool support is coming in a future release.`,\n    );\n  }\n  if (typeof input.before === \"function\" && !input.page) {\n    throw new ExpectConfigError(\n      \"Function before requires a page.\",\n      `Pass a Playwright Page: Expect.test({ page, before: async (page) => { ... }, tests: [...] })`,\n    );\n  }\n  if (typeof input.after === \"function\" && !input.page) {\n    throw new ExpectConfigError(\n      \"Function after requires a page.\",\n      `Pass a Playwright Page: Expect.test({ page, after: async (page) => { ... }, tests: [...] })`,\n    );\n  }\n};\n\nconst validateSessionConfig = (config: SessionConfig): void => {\n  if (config.browserContext) {\n    throw new ExpectConfigError(\n      \"External browserContext is not yet supported.\",\n      `Remove the browserContext field. The SDK manages browser lifecycle internally.`,\n    );\n  }\n  if (config.tools && config.tools.length > 0) {\n    throw new ExpectConfigError(\n      \"Custom tools are not yet supported.\",\n      `Remove the tools field for now. Tool support is coming in a future release.`,\n    );\n  }\n};\n\ninterface ResolvedCookies {\n  readonly browserKeys: readonly string[];\n  readonly explicitCookies: readonly Cookie[];\n}\n\nconst isBrowserNameArray = (cookies: readonly unknown[]): cookies is readonly string[] =>\n  cookies.length > 0 && typeof cookies[0] === \"string\";\n\nconst resolveCookies = (cookies: TestInput[\"cookies\"]): ResolvedCookies => {\n  if (cookies === undefined) return { browserKeys: [], explicitCookies: [] };\n  if (cookies === true) return { browserKeys: [\"chrome\"], explicitCookies: [] };\n  if (typeof cookies === \"string\") return { browserKeys: [cookies], explicitCookies: [] };\n  if (Array.isArray(cookies)) {\n    if (isBrowserNameArray(cookies)) {\n      return { browserKeys: cookies, explicitCookies: [] };\n    }\n    return { browserKeys: [], explicitCookies: cookies };\n  }\n  return { browserKeys: [], explicitCookies: [] };\n};\n\nconst buildInstructionWithActions = (\n  url: string,\n  tests: readonly Test[],\n  before: TestInput[\"before\"],\n  beforeContext: string | undefined,\n  after: TestInput[\"after\"],\n): string => {\n  const prompts = normalizeTestPrompts(tests);\n  let instruction = buildInstruction(url, prompts);\n\n  if (typeof before === \"string\") {\n    instruction = `Before: ${before}\\n\\n${instruction}`;\n  }\n  if (beforeContext) {\n    instruction = `Context from before: ${beforeContext}\\n\\n${instruction}`;\n  }\n  if (typeof after === \"string\") {\n    instruction = `${instruction}\\n\\nAfter: ${after}`;\n  }\n\n  return instruction;\n};\n\ninterface ExecutionContext {\n  readonly url: string;\n  readonly startedAt: number;\n  readonly eventBuffer: TestEvent[];\n  readonly resolveWaiter: { current: (() => void) | undefined };\n}\n\nconst executeTests = Effect.fn(\"Sdk.executeTests\")(function* (\n  executeOptions: ExecuteOptions,\n  context: ExecutionContext,\n) {\n  yield* Effect.annotateCurrentSpan({\n    url: context.url,\n    isHeadless: executeOptions.isHeadless,\n  });\n\n  const executor = yield* Executor;\n  let previousEvents: readonly ExecutionEvent[] = [];\n\n  const finalExecuted = yield* executor.execute(executeOptions).pipe(\n    Stream.tap((executed: ExecutedTestPlan) =>\n      Effect.sync(() => {\n        const newEvents = diffEvents(\n          previousEvents,\n          executed.events,\n          executed,\n          context.url,\n          context.startedAt,\n        );\n        previousEvents = executed.events;\n        for (const event of newEvents) {\n          context.eventBuffer.push(event);\n        }\n        context.resolveWaiter.current?.();\n      }),\n    ),\n    Stream.runLast,\n    Effect.flatMap((option) =>\n      Option.match(option, {\n        onNone: () => Effect.fail(new ExpectTimeoutError({ timeoutMs: 0 })),\n        onSome: (executed) => Effect.succeed(executed.finalizeTextBlock().synthesizeRunFinished()),\n      }),\n    ),\n  );\n\n  const artifacts = extractArtifacts(finalExecuted.events);\n  const result = buildTestResult(finalExecuted, context.url, context.startedAt, artifacts);\n\n  if (!context.eventBuffer.some((event) => event.type === \"completed\")) {\n    context.eventBuffer.push({ type: \"completed\", result });\n  }\n\n  context.resolveWaiter.current?.();\n  return result;\n});\n\nconst extractCookies = Effect.fn(\"Sdk.extractCookies\")(function* (keys: readonly string[]) {\n  yield* Effect.annotateCurrentSpan({ browserKeys: keys.join(\",\") });\n\n  const cookiesService = yield* CookiesService;\n  const browsers = yield* Browsers;\n  const allBrowsers = yield* browsers.list;\n\n  const matchingBrowsers = allBrowsers.filter((browser) =>\n    keys.some((key) => {\n      if (browser._tag === \"ChromiumBrowser\") return browser.key === key;\n      if (browser._tag === \"FirefoxBrowser\") return key === \"firefox\";\n      if (browser._tag === \"SafariBrowser\") return key === \"safari\";\n      return false;\n    }),\n  );\n\n  const results = yield* Effect.forEach(\n    matchingBrowsers,\n    (browser) => cookiesService.extract(browser),\n    { concurrency: \"unbounded\" },\n  );\n\n  return results.flat().map((cookie): Cookie => {\n    const formatted = cookie.playwrightFormat;\n    return { ...formatted, sameSite: formatted.sameSite ?? \"Lax\" };\n  });\n});\n\nconst createAsyncIterator = (\n  eventBuffer: TestEvent[],\n  resolveWaiter: { current: (() => void) | undefined },\n  getFinished: () => boolean,\n  getError: () => unknown,\n): (() => AsyncIterableIterator<TestEvent>) => {\n  return () => {\n    let cursor = 0;\n\n    return {\n      async next(): Promise<IteratorResult<TestEvent>> {\n        while (true) {\n          if (cursor < eventBuffer.length) {\n            const event = eventBuffer[cursor];\n            cursor++;\n            if (event.type === \"completed\") {\n              return { done: true, value: undefined };\n            }\n            return { done: false, value: event };\n          }\n\n          if (getFinished()) {\n            const error = getError();\n            if (error) throw error;\n            return { done: true, value: undefined };\n          }\n\n          await new Promise<void>((resolve) => {\n            resolveWaiter.current = resolve;\n          });\n        }\n      },\n\n      [Symbol.asyncIterator]() {\n        return this;\n      },\n    };\n  };\n};\n\nconst runExecution = (\n  url: string,\n  tests: readonly Test[],\n  input: {\n    cookies?: TestInput[\"cookies\"];\n    mode?: \"headed\" | \"headless\";\n    timeout?: number;\n    isRecording?: boolean;\n    before?: TestInput[\"before\"];\n    after?: TestInput[\"after\"];\n    page?: Page;\n  },\n): { promise: Promise<TestResult>; subscribe: () => AsyncIterableIterator<TestEvent> } => {\n  const config = getGlobalConfig();\n  const timeoutMs = input.timeout ?? config.timeout ?? DEFAULT_TIMEOUT_MS;\n  const isHeadless = (input.mode ?? config.mode ?? \"headless\") === \"headless\";\n  const resolved = resolveCookies(input.cookies ?? config.cookies);\n  const rootDir = config.rootDir ?? process.cwd();\n\n  const eventBuffer: TestEvent[] = [];\n  const resolveWaiter: { current: (() => void) | undefined } = { current: undefined };\n  let finished = false;\n  let executionError: unknown;\n\n  const startExecution = async (): Promise<TestResult> => {\n    let beforeContext: string | undefined;\n    if (typeof input.before === \"function\" && input.page) {\n      const beforeResult = await input.before(input.page);\n      if (typeof beforeResult === \"string\") {\n        beforeContext = beforeResult;\n      }\n    }\n\n    const instruction = buildInstructionWithActions(\n      url,\n      tests,\n      input.before,\n      beforeContext,\n      input.after,\n    );\n\n    const executeOptions: ExecuteOptions = {\n      changesFor: ChangesFor.makeUnsafe({ _tag: \"WorkingTree\" }),\n      instruction,\n      isHeadless,\n      cookieBrowserKeys: [...resolved.browserKeys],\n      baseUrl: url,\n    };\n\n    const context: ExecutionContext = {\n      url,\n      startedAt: Date.now(),\n      eventBuffer,\n      resolveWaiter,\n    };\n\n    const program = executeTests(executeOptions, context).pipe(\n      Effect.timeoutOrElse({\n        duration: `${timeoutMs} millis`,\n        onTimeout: () => Effect.fail(new ExpectTimeoutError({ timeoutMs })),\n      }),\n      Effect.provide(layerSdk(DEFAULT_AGENT_BACKEND, rootDir)),\n      Effect.provide(NodeServices.layer),\n    );\n\n    const result = await Effect.runPromise(program);\n\n    if (typeof input.after === \"function\" && input.page) {\n      await input.after(input.page);\n    }\n\n    return result;\n  };\n\n  const promise = startExecution().then(\n    (result) => {\n      finished = true;\n      resolveWaiter.current?.();\n      return result;\n    },\n    (error) => {\n      executionError = error;\n      finished = true;\n      resolveWaiter.current?.();\n      throw error;\n    },\n  );\n\n  const subscribe = createAsyncIterator(\n    eventBuffer,\n    resolveWaiter,\n    () => finished,\n    () => executionError,\n  );\n\n  return { promise, subscribe };\n};\n\nconst test = (input: TestInput): TestRun => {\n  validateTestInput(input);\n  const url = resolveInputUrl(input);\n  const { promise, subscribe } = runExecution(url, input.tests, input);\n  return createTestRun({ promise, subscribe });\n};\n\nconst session = (config: SessionConfig): ExpectSession => {\n  validateSessionConfig(config);\n\n  const sessionTest = (input: SessionTestInput): TestRun => {\n    validateTests(input.tests);\n    const testUrl = input.url ?? config.url;\n    const globalCfg = getGlobalConfig();\n\n    let resolvedUrl: string;\n    if (testUrl !== undefined) {\n      resolvedUrl = resolveUrl(testUrl, globalCfg.baseUrl ?? config.url);\n    } else if (config.url) {\n      resolvedUrl = config.url;\n    } else if (globalCfg.baseUrl) {\n      resolvedUrl = globalCfg.baseUrl;\n    } else {\n      throw new ExpectConfigError(\n        \"No URL provided for session test and no baseUrl configured.\",\n        `session.test({ url: \"/page\", tests: [...] })`,\n      );\n    }\n\n    const { promise, subscribe } = runExecution(resolvedUrl, input.tests, {\n      cookies: config.cookies,\n      mode: input.mode ?? config.mode,\n      timeout: input.timeout ?? config.timeout,\n      isRecording: input.isRecording ?? config.isRecording,\n      before: input.before,\n      after: input.after,\n    });\n\n    return createTestRun({ promise, subscribe });\n  };\n\n  const close = async (): Promise<void> => {\n    // HACK: browser lifecycle is managed by the executor internally for now\n  };\n\n  return {\n    test: sessionTest,\n    close,\n    [Symbol.asyncDispose]: close,\n  };\n};\n\nconst cookies = (browser: true | BrowserName | BrowserName[]): Promise<Cookie[]> => {\n  const keys: string[] =\n    browser === true ? [\"chrome\"] : typeof browser === \"string\" ? [browser] : browser;\n\n  return Effect.runPromise(\n    Effect.scoped(extractCookies(keys)).pipe(\n      Effect.provide(CookiesService.layer),\n      Effect.provide(cookiesLayerLive),\n      Effect.provide(NodeServices.layer),\n    ),\n  );\n};\n\nexport const Expect = { test, session, cookies } as const;\n","import type { StandardJSONSchemaV1 } from \"@standard-schema/spec\";\nimport type { Tool } from \"./types\";\n\ntype SchemaInput = StandardJSONSchemaV1 | Record<string, unknown>;\n\nconst isStandardSchema = (schema: SchemaInput): schema is StandardJSONSchemaV1 =>\n  \"~standard\" in schema && typeof (schema as Record<string, unknown>)[\"~standard\"] === \"object\";\n\nconst toInputSchema = (schema: SchemaInput): Tool[\"inputSchema\"] => {\n  if (isStandardSchema(schema)) {\n    return schema[\"~standard\"].jsonSchema.input({ target: \"draft-07\" }) as Tool[\"inputSchema\"];\n  }\n  return schema as Tool[\"inputSchema\"];\n};\n\nexport const tool = (\n  name: string,\n  description: string,\n  schema: SchemaInput,\n  handler: (input: Record<string, unknown>) => Promise<string>,\n): Tool => ({\n  name,\n  description,\n  inputSchema: toInputSchema(schema),\n  handler,\n});\n"],"mappings":";;;;;;;AAEA,IAAI,eAA6B,EAAE;AAEnC,MAAa,gBAAgB,WAAuC;AAEpE,MAAa,aAAa,WAAwC;AAChE,gBAAe;EAAE,GAAG;EAAc,GAAG;EAAQ;;AAG/C,MAAa,wBAAsC;;;ACHnD,MAAa,iBAAiB,eAA0C;CACtE,KACE,aACA,YACkC;AAClC,SAAO,UAAU,QAAQ,KAAK,aAAa,WAAW;;CAGxD,CAAC,OAAO,iBAA2C;AACjD,SAAO,UAAU,WAAW;;CAE/B;;;ACYD,MAAM,wBAAwB,UAC5B,MAAM,KAAK,SAAU,OAAO,SAAS,WAAW,OAAO,KAAK,OAAQ;AAEtE,MAAM,mBAAmB,UAAiD;CACxE,MAAM,SAAS,iBAAiB;AAEhC,KAAI,MAAM,KACR,QAAO,MAAM,KAAK,KAAK;AAGzB,KAAI,MAAM,QAAQ,KAAA,EAChB,QAAO,WAAW,MAAM,KAAK,OAAO,QAAQ;AAG9C,KAAI,OAAO,QACT,QAAO,OAAO;AAGhB,OAAM,IAAI,kBACR,8CACA,mHACD;;AAGH,MAAM,iBAAiB,UAAiC;AACtD,KAAI,MAAM,WAAW,EACnB,OAAM,IAAI,kBACR,yBACA,4DACD;;AAIL,MAAM,qBAAqB,UAA2B;AACpD,eAAc,MAAM,MAAM;AAC1B,KAAI,MAAM,SAAS,MAAM,MAAM,SAAS,EACtC,OAAM,IAAI,kBACR,uCACA,8EACD;AAEH,KAAI,OAAO,MAAM,WAAW,cAAc,CAAC,MAAM,KAC/C,OAAM,IAAI,kBACR,oCACA,+FACD;AAEH,KAAI,OAAO,MAAM,UAAU,cAAc,CAAC,MAAM,KAC9C,OAAM,IAAI,kBACR,mCACA,8FACD;;AAIL,MAAM,yBAAyB,WAAgC;AAC7D,KAAI,OAAO,eACT,OAAM,IAAI,kBACR,iDACA,iFACD;AAEH,KAAI,OAAO,SAAS,OAAO,MAAM,SAAS,EACxC,OAAM,IAAI,kBACR,uCACA,8EACD;;AASL,MAAM,sBAAsB,YAC1B,QAAQ,SAAS,KAAK,OAAO,QAAQ,OAAO;AAE9C,MAAM,kBAAkB,YAAmD;AACzE,KAAI,YAAY,KAAA,EAAW,QAAO;EAAE,aAAa,EAAE;EAAE,iBAAiB,EAAE;EAAE;AAC1E,KAAI,YAAY,KAAM,QAAO;EAAE,aAAa,CAAC,SAAS;EAAE,iBAAiB,EAAE;EAAE;AAC7E,KAAI,OAAO,YAAY,SAAU,QAAO;EAAE,aAAa,CAAC,QAAQ;EAAE,iBAAiB,EAAE;EAAE;AACvF,KAAI,MAAM,QAAQ,QAAQ,EAAE;AAC1B,MAAI,mBAAmB,QAAQ,CAC7B,QAAO;GAAE,aAAa;GAAS,iBAAiB,EAAE;GAAE;AAEtD,SAAO;GAAE,aAAa,EAAE;GAAE,iBAAiB;GAAS;;AAEtD,QAAO;EAAE,aAAa,EAAE;EAAE,iBAAiB,EAAE;EAAE;;AAGjD,MAAM,+BACJ,KACA,OACA,QACA,eACA,UACW;CAEX,IAAI,cAAc,iBAAiB,KADnB,qBAAqB,MAAM,CACK;AAEhD,KAAI,OAAO,WAAW,SACpB,eAAc,WAAW,OAAO,MAAM;AAExC,KAAI,cACF,eAAc,wBAAwB,cAAc,MAAM;AAE5D,KAAI,OAAO,UAAU,SACnB,eAAc,GAAG,YAAY,aAAa;AAG5C,QAAO;;AAUT,MAAM,eAAe,OAAO,GAAG,mBAAmB,CAAC,WACjD,gBACA,SACA;AACA,QAAO,OAAO,oBAAoB;EAChC,KAAK,QAAQ;EACb,YAAY,eAAe;EAC5B,CAAC;CAEF,MAAM,WAAW,OAAO;CACxB,IAAI,iBAA4C,EAAE;CAElD,MAAM,gBAAgB,OAAO,SAAS,QAAQ,eAAe,CAAC,KAC5D,OAAO,KAAK,aACV,OAAO,WAAW;EAChB,MAAM,YAAY,WAChB,gBACA,SAAS,QACT,UACA,QAAQ,KACR,QAAQ,UACT;AACD,mBAAiB,SAAS;AAC1B,OAAK,MAAM,SAAS,UAClB,SAAQ,YAAY,KAAK,MAAM;AAEjC,UAAQ,cAAc,WAAW;GACjC,CACH,EACD,OAAO,SACP,OAAO,SAAS,WACd,OAAO,MAAM,QAAQ;EACnB,cAAc,OAAO,KAAK,IAAI,mBAAmB,EAAE,WAAW,GAAG,CAAC,CAAC;EACnE,SAAS,aAAa,OAAO,QAAQ,SAAS,mBAAmB,CAAC,uBAAuB,CAAC;EAC3F,CAAC,CACH,CACF;CAED,MAAM,YAAY,iBAAiB,cAAc,OAAO;CACxD,MAAM,SAAS,gBAAgB,eAAe,QAAQ,KAAK,QAAQ,WAAW,UAAU;AAExF,KAAI,CAAC,QAAQ,YAAY,MAAM,UAAU,MAAM,SAAS,YAAY,CAClE,SAAQ,YAAY,KAAK;EAAE,MAAM;EAAa;EAAQ,CAAC;AAGzD,SAAQ,cAAc,WAAW;AACjC,QAAO;EACP;AAEF,MAAM,iBAAiB,OAAO,GAAG,qBAAqB,CAAC,WAAW,MAAyB;AACzF,QAAO,OAAO,oBAAoB,EAAE,aAAa,KAAK,KAAK,IAAI,EAAE,CAAC;CAElE,MAAM,iBAAiB,OAAOA;CAI9B,MAAM,oBAFc,QADH,OAAO,UACY,MAEC,QAAQ,YAC3C,KAAK,MAAM,QAAQ;AACjB,MAAI,QAAQ,SAAS,kBAAmB,QAAO,QAAQ,QAAQ;AAC/D,MAAI,QAAQ,SAAS,iBAAkB,QAAO,QAAQ;AACtD,MAAI,QAAQ,SAAS,gBAAiB,QAAO,QAAQ;AACrD,SAAO;GACP,CACH;AAQD,SANgB,OAAO,OAAO,QAC5B,mBACC,YAAY,eAAe,QAAQ,QAAQ,EAC5C,EAAE,aAAa,aAAa,CAC7B,EAEc,MAAM,CAAC,KAAK,WAAmB;EAC5C,MAAM,YAAY,OAAO;AACzB,SAAO;GAAE,GAAG;GAAW,UAAU,UAAU,YAAY;GAAO;GAC9D;EACF;AAEF,MAAM,uBACJ,aACA,eACA,aACA,aAC6C;AAC7C,cAAa;EACX,IAAI,SAAS;AAEb,SAAO;GACL,MAAM,OAA2C;AAC/C,WAAO,MAAM;AACX,SAAI,SAAS,YAAY,QAAQ;MAC/B,MAAM,QAAQ,YAAY;AAC1B;AACA,UAAI,MAAM,SAAS,YACjB,QAAO;OAAE,MAAM;OAAM,OAAO,KAAA;OAAW;AAEzC,aAAO;OAAE,MAAM;OAAO,OAAO;OAAO;;AAGtC,SAAI,aAAa,EAAE;MACjB,MAAM,QAAQ,UAAU;AACxB,UAAI,MAAO,OAAM;AACjB,aAAO;OAAE,MAAM;OAAM,OAAO,KAAA;OAAW;;AAGzC,WAAM,IAAI,SAAe,YAAY;AACnC,oBAAc,UAAU;OACxB;;;GAIN,CAAC,OAAO,iBAAiB;AACvB,WAAO;;GAEV;;;AAIL,MAAM,gBACJ,KACA,OACA,UASwF;CACxF,MAAM,SAAS,iBAAiB;CAChC,MAAM,YAAY,MAAM,WAAW,OAAO,WAAA;CAC1C,MAAM,cAAc,MAAM,QAAQ,OAAO,QAAQ,gBAAgB;CACjE,MAAM,WAAW,eAAe,MAAM,WAAW,OAAO,QAAQ;CAChE,MAAM,UAAU,OAAO,WAAW,QAAQ,KAAK;CAE/C,MAAM,cAA2B,EAAE;CACnC,MAAM,gBAAuD,EAAE,SAAS,KAAA,GAAW;CACnF,IAAI,WAAW;CACf,IAAI;CAEJ,MAAM,iBAAiB,YAAiC;EACtD,IAAI;AACJ,MAAI,OAAO,MAAM,WAAW,cAAc,MAAM,MAAM;GACpD,MAAM,eAAe,MAAM,MAAM,OAAO,MAAM,KAAK;AACnD,OAAI,OAAO,iBAAiB,SAC1B,iBAAgB;;EAIpB,MAAM,cAAc,4BAClB,KACA,OACA,MAAM,QACN,eACA,MAAM,MACP;EAiBD,MAAM,UAAU,aAfuB;GACrC,YAAY,WAAW,WAAW,EAAE,MAAM,eAAe,CAAC;GAC1D;GACA;GACA,mBAAmB,CAAC,GAAG,SAAS,YAAY;GAC5C,SAAS;GACV,EAEiC;GAChC;GACA,WAAW,KAAK,KAAK;GACrB;GACA;GACD,CAEoD,CAAC,KACpD,OAAO,cAAc;GACnB,UAAU,GAAG,UAAU;GACvB,iBAAiB,OAAO,KAAK,IAAI,mBAAmB,EAAE,WAAW,CAAC,CAAC;GACpE,CAAC,EACF,OAAO,QAAQ,SAAS,uBAAuB,QAAQ,CAAC,EACxD,OAAO,QAAQ,aAAa,MAAM,CACnC;EAED,MAAM,SAAS,MAAM,OAAO,WAAW,QAAQ;AAE/C,MAAI,OAAO,MAAM,UAAU,cAAc,MAAM,KAC7C,OAAM,MAAM,MAAM,MAAM,KAAK;AAG/B,SAAO;;AAwBT,QAAO;EAAE,SArBO,gBAAgB,CAAC,MAC9B,WAAW;AACV,cAAW;AACX,iBAAc,WAAW;AACzB,UAAO;MAER,UAAU;AACT,oBAAiB;AACjB,cAAW;AACX,iBAAc,WAAW;AACzB,SAAM;IAET;EASiB,WAPA,oBAChB,aACA,qBACM,gBACA,eACP;EAE4B;;AAG/B,MAAM,QAAQ,UAA8B;AAC1C,mBAAkB,MAAM;CAExB,MAAM,EAAE,SAAS,cAAc,aADnB,gBAAgB,MAAM,EACe,MAAM,OAAO,MAAM;AACpE,QAAO,cAAc;EAAE;EAAS;EAAW,CAAC;;AAG9C,MAAM,WAAW,WAAyC;AACxD,uBAAsB,OAAO;CAE7B,MAAM,eAAe,UAAqC;AACxD,gBAAc,MAAM,MAAM;EAC1B,MAAM,UAAU,MAAM,OAAO,OAAO;EACpC,MAAM,YAAY,iBAAiB;EAEnC,IAAI;AACJ,MAAI,YAAY,KAAA,EACd,eAAc,WAAW,SAAS,UAAU,WAAW,OAAO,IAAI;WACzD,OAAO,IAChB,eAAc,OAAO;WACZ,UAAU,QACnB,eAAc,UAAU;MAExB,OAAM,IAAI,kBACR,+DACA,+CACD;EAGH,MAAM,EAAE,SAAS,cAAc,aAAa,aAAa,MAAM,OAAO;GACpE,SAAS,OAAO;GAChB,MAAM,MAAM,QAAQ,OAAO;GAC3B,SAAS,MAAM,WAAW,OAAO;GACjC,aAAa,MAAM,eAAe,OAAO;GACzC,QAAQ,MAAM;GACd,OAAO,MAAM;GACd,CAAC;AAEF,SAAO,cAAc;GAAE;GAAS;GAAW,CAAC;;CAG9C,MAAM,QAAQ,YAA2B;AAIzC,QAAO;EACL,MAAM;EACN;GACC,OAAO,eAAe;EACxB;;AAGH,MAAM,WAAW,YAAmE;CAClF,MAAM,OACJ,YAAY,OAAO,CAAC,SAAS,GAAG,OAAO,YAAY,WAAW,CAAC,QAAQ,GAAG;AAE5E,QAAO,OAAO,WACZ,OAAO,OAAO,eAAe,KAAK,CAAC,CAAC,KAClC,OAAO,QAAQA,QAAe,MAAM,EACpC,OAAO,QAAQC,UAAiB,EAChC,OAAO,QAAQ,aAAa,MAAM,CACnC,CACF;;AAGH,MAAa,SAAS;CAAE;CAAM;CAAS;CAAS;;;AC1ahD,MAAM,oBAAoB,WACxB,eAAe,UAAU,OAAQ,OAAmC,iBAAiB;AAEvF,MAAM,iBAAiB,WAA6C;AAClE,KAAI,iBAAiB,OAAO,CAC1B,QAAO,OAAO,aAAa,WAAW,MAAM,EAAE,QAAQ,YAAY,CAAC;AAErE,QAAO;;AAGT,MAAa,QACX,MACA,aACA,QACA,aACU;CACV;CACA;CACA,aAAa,cAAc,OAAO;CAClC;CACD"}

package/dist/types-0J0EwTM4.d.mts

@@ -0,0 +1,124 @@
+import { Schema } from "effect";
+import * as effect_Cause0 from "effect/Cause";
+import { BrowserContext, Cookie, Page } from "playwright";
+import { Tool } from "@modelcontextprotocol/sdk/types.js";
+
+//#region src/errors.d.ts
+declare const ExpectTimeoutError_base: Schema.ErrorClass<ExpectTimeoutError, Schema.Struct<{
+  readonly _tag: Schema.tag<"ExpectTimeoutError">;
+  readonly timeoutMs: Schema.Number;
+}>, effect_Cause0.YieldableError>;
+declare class ExpectTimeoutError extends ExpectTimeoutError_base {
+  message: string;
+}
+declare class ExpectConfigError extends Error {
+  constructor(message: string, fix: string);
+}
+//#endregion
+//#region src/constants.d.ts
+declare const DEFAULT_TIMEOUT_MS: number;
+declare const DEFAULT_AGENT_BACKEND: "claude";
+//#endregion
+//#region src/types.d.ts
+type Action = string | ((page: Page) => Promise<void | string>);
+type BrowserName = "chrome" | "firefox" | "safari" | "edge" | "brave" | "arc";
+type CookieInput = true | BrowserName | BrowserName[] | Cookie[];
+type Test = string | {
+  title?: string;
+  prompt: string;
+};
+type Status = "pending" | "passed" | "failed";
+interface Tool$1 extends Pick<Tool, "name" | "description" | "inputSchema"> {
+  readonly handler: (input: Record<string, unknown>) => Promise<string>;
+}
+interface StepResult {
+  readonly title: string;
+  readonly status: Status;
+  readonly summary: string;
+  readonly screenshotPath?: string;
+  readonly duration: number;
+}
+interface TestResult {
+  readonly status: Status;
+  readonly url: string;
+  readonly duration: number;
+  readonly recordingPath?: string;
+  readonly steps: StepResult[];
+  readonly errors: StepResult[];
+}
+type TestEvent = {
+  readonly type: "run:started";
+  readonly title: string;
+  readonly baseUrl?: string;
+} | {
+  readonly type: "step:started";
+  readonly title: string;
+} | {
+  readonly type: "step:passed";
+  readonly step: StepResult;
+} | {
+  readonly type: "step:failed";
+  readonly step: StepResult;
+} | {
+  readonly type: "step:skipped";
+  readonly title: string;
+  readonly reason: string;
+} | {
+  readonly type: "screenshot";
+  readonly title: string;
+  readonly path: string;
+} | {
+  readonly type: "completed";
+  readonly result: TestResult;
+};
+interface TestRun extends PromiseLike<TestResult> {
+  [Symbol.asyncIterator](): AsyncIterator<TestEvent>;
+}
+interface TestInput {
+  readonly url?: string;
+  readonly page?: Page;
+  readonly cookies?: CookieInput;
+  readonly tools?: Tool$1[];
+  readonly tests: Test[];
+  readonly before?: Action;
+  readonly after?: Action;
+  readonly mode?: "headed" | "headless";
+  readonly timeout?: number;
+  readonly isRecording?: boolean;
+}
+interface SessionConfig {
+  readonly url?: string;
+  readonly browserContext?: BrowserContext;
+  readonly cookies?: CookieInput;
+  readonly tools?: Tool$1[];
+  readonly mode?: "headed" | "headless";
+  readonly timeout?: number;
+  readonly isRecording?: boolean;
+}
+interface SessionTestInput {
+  readonly url?: string;
+  readonly tests: Test[];
+  readonly before?: Action;
+  readonly after?: Action;
+  readonly mode?: "headed" | "headless";
+  readonly timeout?: number;
+  readonly isRecording?: boolean;
+}
+interface ExpectSession {
+  test(input: SessionTestInput): TestRun;
+  close(): Promise<void>;
+  [Symbol.asyncDispose](): Promise<void>;
+}
+interface ExpectConfig {
+  readonly baseUrl?: string;
+  readonly browser?: BrowserName;
+  readonly mode?: "headed" | "headless";
+  readonly cookies?: CookieInput;
+  readonly timeout?: number;
+  readonly model?: string;
+  readonly apiKey?: string;
+  readonly rootDir?: string;
+}
+//#endregion
+export { DEFAULT_AGENT_BACKEND as _, ExpectConfig as a, ExpectTimeoutError as b, SessionTestInput as c, Test as d, TestEvent as f, Tool$1 as g, TestRun as h, CookieInput as i, Status as l, TestResult as m, BrowserName as n, ExpectSession as o, TestInput as p, Cookie as r, SessionConfig as s, Action as t, StepResult as u, DEFAULT_TIMEOUT_MS as v, ExpectConfigError as y };
+//# sourceMappingURL=types-0J0EwTM4.d.mts.map

package/dist/types-0J0EwTM4.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-0J0EwTM4.d.mts","names":[],"sources":["../src/errors.ts","../src/constants.ts","../src/types.ts"],"mappings":";;;;;;cAAgC,uBAAA;;;;cAEnB,kBAAA,SAA2B,uBAAA;EAMtC,OAAA;AAAA;AAAA,cAGW,iBAAA,SAA0B,KAAA;cACzB,OAAA,UAAiB,GAAA;AAAA;;;cCZlB,kBAAA;AAAA,cACA,qBAAA;;;KCID,MAAA,cAAoB,IAAA,EAAM,IAAA,KAAS,OAAA;AAAA,KAEnC,WAAA;AAAA,KAEA,WAAA,UAAqB,WAAA,GAAc,WAAA,KAAgB,MAAA;AAAA,KAEnD,IAAA;EAAkB,KAAA;EAAgB,MAAA;AAAA;AAAA,KAElC,MAAA;AAAA,UAEK,MAAA,SAAa,IAAA,CAAK,IAAA;EAAA,SACxB,OAAA,GAAU,KAAA,EAAO,MAAA,sBAA4B,OAAA;AAAA;AAAA,UAGvC,UAAA;EAAA,SACN,KAAA;EAAA,SACA,MAAA,EAAQ,MAAA;EAAA,SACR,OAAA;EAAA,SACA,cAAA;EAAA,SACA,QAAA;AAAA;AAAA,UAGM,UAAA;EAAA,SACN,MAAA,EAAQ,MAAA;EAAA,SACR,GAAA;EAAA,SACA,QAAA;EAAA,SACA,aAAA;EAAA,SACA,KAAA,EAAO,UAAA;EAAA,SACP,MAAA,EAAQ,UAAA;AAAA;AAAA,KAGP,SAAA;EAAA,SACG,IAAA;EAAA,SAA8B,KAAA;EAAA,SAAwB,OAAA;AAAA;EAAA,SACtD,IAAA;EAAA,SAA+B,KAAA;AAAA;EAAA,SAC/B,IAAA;EAAA,SAA8B,IAAA,EAAM,UAAA;AAAA;EAAA,SACpC,IAAA;EAAA,SAA8B,IAAA,EAAM,UAAA;AAAA;EAAA,SACpC,IAAA;EAAA,SAA+B,KAAA;EAAA,SAAwB,MAAA;AAAA;EAAA,SACvD,IAAA;EAAA,SAA6B,KAAA;EAAA,SAAwB,IAAA;AAAA;EAAA,SACrD,IAAA;EAAA,SAA4B,MAAA,EAAQ,UAAA;AAAA;AAAA,UAElC,OAAA,SAAgB,WAAA,CAAY,UAAA;EAAA,CAC1C,MAAA,CAAO,aAAP,KAAyB,aAAA,CAAc,SAAA;AAAA;AAAA,UAGzB,SAAA;EAAA,SACN,GAAA;EAAA,SACA,IAAA,GAAO,IAAA;EAAA,SACP,OAAA,GAAU,WAAA;EAAA,SACV,KAAA,GAAQ,MAAA;EAAA,SACR,KAAA,EAAO,IAAA;EAAA,SACP,MAAA,GAAS,MAAA;EAAA,SACT,KAAA,GAAQ,MAAA;EAAA,SACR,IAAA;EAAA,SACA,OAAA;EAAA,SACA,WAAA;AAAA;AAAA,UAGM,aAAA;EAAA,SACN,GAAA;EAAA,SACA,cAAA,GAAiB,cAAA;EAAA,SACjB,OAAA,GAAU,WAAA;EAAA,SACV,KAAA,GAAQ,MAAA;EAAA,SACR,IAAA;EAAA,SACA,OAAA;EAAA,SACA,WAAA;AAAA;AAAA,UAGM,gBAAA;EAAA,SACN,GAAA;EAAA,SACA,KAAA,EAAO,IAAA;EAAA,SACP,MAAA,GAAS,MAAA;EAAA,SACT,KAAA,GAAQ,MAAA;EAAA,SACR,IAAA;EAAA,SACA,OAAA;EAAA,SACA,WAAA;AAAA;AAAA,UAGM,aAAA;EACf,IAAA,CAAK,KAAA,EAAO,gBAAA,GAAmB,OAAA;EAC/B,KAAA,IAAS,OAAA;EAAA,CACR,MAAA,CAAO,YAAP,KAAwB,OAAA;AAAA;AAAA,UAGV,YAAA;EAAA,SACN,OAAA;EAAA,SACA,OAAA,GAAU,WAAA;EAAA,SACV,IAAA;EAAA,SACA,OAAA,GAAU,WAAA;EAAA,SACV,OAAA;EAAA,SACA,KAAA;EAAA,SACA,MAAA;EAAA,SACA,OAAA;AAAA"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "expect-sdk",
+  "version": "0.0.24",
+  "publishConfig": {
+    "tag": "alpha"
+  },
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts",
+    "./effect": "./src/effect.ts"
+  },
+  "dependencies": {
+    "@effect/platform-node": "4.0.0-beta.35",
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@standard-schema/spec": "^1.1.0",
+    "effect": "4.0.0-beta.35",
+    "@expect/agent": "0.0.24",
+    "@expect/shared": "0.0.24",
+    "@expect/supervisor": "0.0.24",
+    "@expect/cookies": "0.0.24"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.11",
+    "@types/node": "^22.15.0",
+    "typescript": "^5.7.0"
+  },
+  "peerDependencies": {
+    "playwright": ">=1.50.0"
+  },
+  "peerDependenciesMeta": {
+    "playwright": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "lint": "vp lint && tsc --noEmit",
+    "format": "vp fmt",
+    "format:check": "vp fmt --check",
+    "build": "vp pack",
+    "check": "vp check",
+    "test": "vp test run",
+    "test:e2e": "~/.bun/bin/bun tests/e2e.ts",
+    "test:watch": "vp test",
+    "typecheck": "tsgo --noEmit"
+  }
+}

package/src/build-instruction.ts

@@ -0,0 +1,35 @@
+import { ExpectConfigError } from "./errors";
+
+export const resolveUrl = (url: unknown, baseUrl: string | undefined): string => {
+  if (typeof url !== "string") {
+    throw new ExpectConfigError(
+      `Expected a URL string, got ${typeof url}.`,
+      `Expect.test({ url: "http://localhost:3000/login", tests: [...] })`,
+    );
+  }
+
+  try {
+    return new URL(url).href;
+  } catch {
+    /* relative URL — falls through to baseUrl resolution */
+  }
+
+  if (!baseUrl) {
+    throw new ExpectConfigError(
+      `No baseUrl configured and URL "${url}" is relative.`,
+      `configure({ baseUrl: "http://localhost:3000" })\nOr use a full URL: Expect.test({ url: "http://localhost:3000${url}", tests: [...] })`,
+    );
+  }
+
+  return new URL(url, baseUrl).href;
+};
+
+export const buildInstruction = (url: string, tests: readonly string[]): string => {
+  const lines = [`Navigate to ${url} and verify the following requirements:`, ""];
+
+  for (const [index, title] of tests.entries()) {
+    lines.push(`${index + 1}. ${title}`);
+  }
+
+  return lines.join("\n");
+};

package/src/config.ts

@@ -0,0 +1,15 @@
+import type { ExpectConfig } from "./types";
+
+let globalConfig: ExpectConfig = {};
+
+export const defineConfig = (config: ExpectConfig): ExpectConfig => config;
+
+export const configure = (config: Partial<ExpectConfig>): void => {
+  globalConfig = { ...globalConfig, ...config };
+};
+
+export const getGlobalConfig = (): ExpectConfig => globalConfig;
+
+export const resetGlobalConfig = (): void => {
+  globalConfig = {};
+};