@neonwatty/limner 0.1.0

package/dist/core/visual-spec-prompts.d.ts

@@ -0,0 +1,32 @@
+import type { TargetPaths } from './workspace.js';
+export declare function buildSharedPrompt(input: {
+    target: TargetPaths;
+    referencePath: string;
+    sideBySidePath: string;
+    factsPath: string;
+    examplePath: string;
+    schemaPath: string;
+    responsePath: string;
+    instructionsPath: string;
+    customInstructions: string;
+}): string;
+export declare function buildCodexPrompt(input: {
+    target: TargetPaths;
+    promptPath: string;
+    referencePath: string;
+    sideBySidePath: string;
+    factsPath: string;
+    schemaPath: string;
+    responsePath: string;
+    instructionsPath: string;
+}): string;
+export declare function buildClaudePrompt(input: {
+    target: TargetPaths;
+    promptPath: string;
+    referencePath: string;
+    sideBySidePath: string;
+    factsPath: string;
+    schemaPath: string;
+    responsePath: string;
+    instructionsPath: string;
+}): string;

package/dist/core/visual-spec-prompts.js

@@ -0,0 +1,129 @@
+import path from 'node:path';
+export function buildSharedPrompt(input) {
+    const rel = relativeToWorkspace(input.target);
+    return `# Visual Spec Extraction Prompt
+
+This workflow requires an agent with image access. Limner does not auto-extract the spec.
+
+## Goal
+
+Inspect the ideal image and the rendered reference, then write a structured JSON response to:
+
+\`${rel(input.responsePath)}\`
+
+Match the structure shown in:
+
+\`${rel(input.examplePath)}\`
+
+Validate against:
+
+\`${rel(input.schemaPath)}\`
+
+## Required Inputs
+
+- Ideal image: \`${rel(input.target.sourceImagePath)}\`
+- Reference screenshot: \`${rel(input.referencePath)}\`
+- Side-by-side: \`${rel(input.sideBySidePath)}\`
+- Reference HTML: \`${rel(input.target.referenceHtmlPath)}\`
+- Reference CSS: \`${rel(input.target.referenceCssPath)}\`
+- Tokens: \`${rel(input.target.tokensPath)}\`
+- Acceptance notes: \`${rel(input.target.acceptancePath)}\`
+- DOM facts: \`${rel(input.factsPath)}\`
+- JSON schema: \`${rel(input.schemaPath)}\`
+- Custom instructions: \`${rel(input.instructionsPath)}\`
+
+## Requirements
+
+- Treat the separate ideal image and separate reference screenshot as primary visual evidence.
+- Use the side-by-side image only as comparison context, not as a source for region bounds or image dimensions.
+- Use the DOM facts only to support the reference-html spec.
+- Do not use placeholders like "TODO" in the final response.
+- Fill all narrative fields with concrete observations.
+- Keep idealSpec.source as \`ideal-image\`.
+- Keep referenceSpec.source as \`reference-html\`.
+- Diff findings should focus on meaningful structural, typographic, or state mismatches.
+
+## Custom Instructions
+
+${input.customInstructions.trim() || 'No custom instructions supplied.'}
+
+## Expected Output
+
+Return one JSON object with:
+
+- \`version\`
+- \`generatedBy\`
+- \`idealSpec\`
+- \`referenceSpec\`
+- \`diff\`
+`;
+}
+export function buildCodexPrompt(input) {
+    const rel = relativeToWorkspace(input.target);
+    return `# Codex Visual Spec Prompt
+
+Use Codex when you want the agent to read local files and write the response directly into the workspace.
+
+## Codex Instructions
+
+1. Inspect these local artifacts:
+   - \`${rel(input.target.sourceImagePath)}\`
+   - \`${rel(input.referencePath)}\`
+   - \`${rel(input.sideBySidePath)}\`
+   - \`${rel(input.target.referenceHtmlPath)}\`
+   - \`${rel(input.target.referenceCssPath)}\`
+   - \`${rel(input.factsPath)}\`
+   - \`${rel(input.schemaPath)}\`
+   - \`${rel(input.instructionsPath)}\`
+2. Produce one JSON object that conforms to the schema.
+3. Write that JSON to:
+   - \`${rel(input.responsePath)}\`
+4. Rerun:
+   - \`limn compare image-reference --target ${input.target.name} --spec\`
+
+## Notes
+
+- Do not return prose instead of JSON.
+- Inspect the ideal image and reference screenshot separately before looking at the side-by-side.
+- Use the side-by-side only as comparison context, not as the image to parse.
+- Use DOM facts only to support the reference-html side, not to infer the ideal-image side.
+- Start from the shared instructions in \`${rel(input.promptPath)}\`.
+`;
+}
+export function buildClaudePrompt(input) {
+    const rel = relativeToWorkspace(input.target);
+    return `# Claude Visual Spec Prompt
+
+Use Claude when you want a multimodal agent to compare the ideal image and the rendered reference with strict structured output.
+
+## Claude Instructions
+
+1. Attach these images when prompting Claude:
+   - \`${rel(input.target.sourceImagePath)}\`
+   - \`${rel(input.referencePath)}\`
+   - \`${rel(input.sideBySidePath)}\`
+2. Also provide these text files:
+   - \`${rel(input.target.referenceHtmlPath)}\`
+   - \`${rel(input.target.referenceCssPath)}\`
+   - \`${rel(input.factsPath)}\`
+   - \`${rel(input.schemaPath)}\`
+   - \`${rel(input.instructionsPath)}\`
+3. Ask Claude to return JSON matching the schema exactly.
+4. Save Claude's JSON response to:
+   - \`${rel(input.responsePath)}\`
+5. Rerun:
+   - \`limn compare image-reference --target ${input.target.name} --spec\`
+
+## Notes
+
+- Prefer Claude structured outputs or strict schema enforcement if available.
+- Do not accept markdown fences or explanatory prose around the JSON.
+- Treat the separate ideal image and reference screenshot as the primary visual evidence.
+- Use the side-by-side only as comparison context, not as the image to parse.
+- Start from the shared instructions in \`${rel(input.promptPath)}\`.
+`;
+}
+function relativeToWorkspace(target) {
+    return (filePath) => path.relative(target.workspace.root, filePath);
+}
+//# sourceMappingURL=visual-spec-prompts.js.map

package/dist/core/visual-spec-prompts.js.map

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

package/dist/core/workspace.d.ts

@@ -0,0 +1,31 @@
+export type WorkspacePaths = {
+    root: string;
+    configPath: string;
+    targetsDir: string;
+    runsDir: string;
+};
+export type TargetPaths = {
+    workspace: WorkspacePaths;
+    name: string;
+    root: string;
+    sourceDir: string;
+    contractDir: string;
+    referenceDir: string;
+    capturesDir: string;
+    reportsDir: string;
+    agentGuidePath: string;
+    sourceImagePath: string;
+    regionsPath: string;
+    tokensPath: string;
+    acceptancePath: string;
+    referenceHtmlPath: string;
+    referenceCssPath: string;
+};
+export declare function resolveWorkspace(root?: string): WorkspacePaths;
+export declare function validateTargetName(target: string): string;
+export declare function resolveTarget(workspaceRoot: string, target: string, sourceFileName?: string): TargetPaths;
+export declare function ensureWorkspace(workspace: WorkspacePaths): Promise<void>;
+export declare function ensureTargetDirs(target: TargetPaths): Promise<void>;
+export declare function writeIfMissing(filePath: string, contents: string, force?: boolean): Promise<'written' | 'skipped'>;
+export declare function copyIfMissing(sourcePath: string, destinationPath: string, force?: boolean): Promise<'written' | 'skipped'>;
+export declare function readJsonFile<T>(filePath: string): Promise<T>;

package/dist/core/workspace.js

@@ -0,0 +1,97 @@
+import { copyFile, mkdir, readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+export function resolveWorkspace(root = process.cwd()) {
+    const resolvedRoot = path.resolve(root);
+    return {
+        root: resolvedRoot,
+        configPath: path.join(resolvedRoot, 'limner.config.ts'),
+        targetsDir: path.join(resolvedRoot, 'targets'),
+        runsDir: path.join(resolvedRoot, '.limner', 'runs'),
+    };
+}
+export function validateTargetName(target) {
+    if (!/^[a-z0-9][a-z0-9-_]*$/i.test(target)) {
+        throw new Error(`Invalid target "${target}". Use letters, numbers, dashes, and underscores.`);
+    }
+    return target;
+}
+export function resolveTarget(workspaceRoot, target, sourceFileName = 'ideal.png') {
+    const workspace = resolveWorkspace(workspaceRoot);
+    const name = validateTargetName(target);
+    const root = path.join(workspace.targetsDir, name);
+    const sourceDir = path.join(root, 'source');
+    const contractDir = path.join(root, 'contract');
+    const referenceDir = path.join(root, 'reference');
+    const capturesDir = path.join(root, 'captures');
+    const reportsDir = path.join(root, 'reports');
+    return {
+        workspace,
+        name,
+        root,
+        sourceDir,
+        contractDir,
+        referenceDir,
+        capturesDir,
+        reportsDir,
+        agentGuidePath: path.join(root, 'AGENT_GUIDE.md'),
+        sourceImagePath: path.join(sourceDir, sourceFileName),
+        regionsPath: path.join(contractDir, 'regions.json'),
+        tokensPath: path.join(contractDir, 'tokens.json'),
+        acceptancePath: path.join(contractDir, 'acceptance.md'),
+        referenceHtmlPath: path.join(referenceDir, 'index.html'),
+        referenceCssPath: path.join(referenceDir, 'styles.css'),
+    };
+}
+export async function ensureWorkspace(workspace) {
+    await mkdir(workspace.targetsDir, { recursive: true });
+    await mkdir(workspace.runsDir, { recursive: true });
+    await writeIfMissing(workspace.configPath, `export default {
+  viewport: { width: 1440, height: 900 },
+  targetsDir: 'targets',
+} as const;
+`);
+}
+export async function ensureTargetDirs(target) {
+    await Promise.all([
+        mkdir(target.sourceDir, { recursive: true }),
+        mkdir(target.contractDir, { recursive: true }),
+        mkdir(path.join(target.referenceDir, 'assets'), { recursive: true }),
+        mkdir(path.join(target.capturesDir, 'image-reference'), { recursive: true }),
+        mkdir(path.join(target.capturesDir, 'reference-app'), { recursive: true }),
+        mkdir(path.join(target.capturesDir, 'reference'), { recursive: true }),
+        mkdir(target.reportsDir, { recursive: true }),
+    ]);
+}
+export async function writeIfMissing(filePath, contents, force = false) {
+    if (!force) {
+        try {
+            await readFile(filePath);
+            return 'skipped';
+        }
+        catch {
+            // Missing file is the expected write path.
+        }
+    }
+    await mkdir(path.dirname(filePath), { recursive: true });
+    await writeFile(filePath, contents);
+    return 'written';
+}
+export async function copyIfMissing(sourcePath, destinationPath, force = false) {
+    if (!force) {
+        try {
+            await readFile(destinationPath);
+            return 'skipped';
+        }
+        catch {
+            // Missing file is the expected copy path.
+        }
+    }
+    await mkdir(path.dirname(destinationPath), { recursive: true });
+    await copyFile(sourcePath, destinationPath);
+    return 'written';
+}
+export async function readJsonFile(filePath) {
+    const raw = await readFile(filePath, 'utf8');
+    return JSON.parse(raw);
+}
+//# sourceMappingURL=workspace.js.map

package/dist/core/workspace.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { limnerRegionCheckSchema, limnerRegionContractSchema, limnerRegionSchema, limnerTokensSchema, } from './schemas/contract.js';
+export type { LimnerRegion, LimnerRegionCheck, LimnerRegionContract, LimnerTokens } from './schemas/contract.js';
+export { limnerRunEventSchema, runManifestSchema } from './schemas/events.js';
+export type { LimnerRunEvent, RunManifest } from './schemas/events.js';
+export { visualSpecBundleSchema, visualSpecDiffSchema, visualSpecSchema, createVisualSpecBundleExample, createVisualSpecJsonSchema } from './schemas/visual-spec.js';
+export type { VisualSpec, VisualSpecBundle, VisualSpecDiff } from './schemas/visual-spec.js';
+export { initTarget } from './commands/init.js';
+export { captureReference } from './commands/capture.js';
+export { compareImageReference, compareReferenceApp } from './commands/compare.js';
+export { compareImageApp } from './commands/compare-image-app.js';
+export { createRunId, createRunLogger } from './core/run-logger.js';
+export { resolveWorkspace, validateTargetName } from './core/workspace.js';
+export { collectReferenceDomFacts } from './core/reference-dom-facts.js';
+export { writeImageReferenceSpecPack } from './core/visual-spec-agent-pack.js';

package/dist/index.js

@@ -0,0 +1,12 @@
+export { limnerRegionCheckSchema, limnerRegionContractSchema, limnerRegionSchema, limnerTokensSchema, } from './schemas/contract.js';
+export { limnerRunEventSchema, runManifestSchema } from './schemas/events.js';
+export { visualSpecBundleSchema, visualSpecDiffSchema, visualSpecSchema, createVisualSpecBundleExample, createVisualSpecJsonSchema } from './schemas/visual-spec.js';
+export { initTarget } from './commands/init.js';
+export { captureReference } from './commands/capture.js';
+export { compareImageReference, compareReferenceApp } from './commands/compare.js';
+export { compareImageApp } from './commands/compare-image-app.js';
+export { createRunId, createRunLogger } from './core/run-logger.js';
+export { resolveWorkspace, validateTargetName } from './core/workspace.js';
+export { collectReferenceDomFacts } from './core/reference-dom-facts.js';
+export { writeImageReferenceSpecPack } from './core/visual-spec-agent-pack.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE9E,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,6BAA6B,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAErK,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/schemas/contract.d.ts

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+export declare const limnerRegionCheckSchema: z.ZodEnum<{
+    bounds: "bounds";
+    visible: "visible";
+    "computed-style": "computed-style";
+    text: "text";
+}>;
+export declare const limnerRegionSchema: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    referenceSelector: z.ZodString;
+    appSelector: z.ZodOptional<z.ZodString>;
+    checks: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        bounds: "bounds";
+        visible: "visible";
+        "computed-style": "computed-style";
+        text: "text";
+    }>>>;
+}, z.core.$strip>;
+export declare const limnerRegionContractSchema: z.ZodObject<{
+    regions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        referenceSelector: z.ZodString;
+        appSelector: z.ZodOptional<z.ZodString>;
+        checks: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            bounds: "bounds";
+            visible: "visible";
+            "computed-style": "computed-style";
+            text: "text";
+        }>>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const limnerTokensSchema: z.ZodObject<{
+    colors: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    radii: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    typography: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+    spacing: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+}, z.core.$strip>;
+export type LimnerRegionCheck = z.infer<typeof limnerRegionCheckSchema>;
+export type LimnerRegion = z.infer<typeof limnerRegionSchema>;
+export type LimnerRegionContract = z.infer<typeof limnerRegionContractSchema>;
+export type LimnerTokens = z.infer<typeof limnerTokensSchema>;

package/dist/schemas/contract.js

@@ -0,0 +1,19 @@
+import { z } from 'zod';
+export const limnerRegionCheckSchema = z.enum(['bounds', 'visible', 'computed-style', 'text']);
+export const limnerRegionSchema = z.object({
+    id: z.string().min(1),
+    label: z.string().min(1),
+    referenceSelector: z.string().min(1),
+    appSelector: z.string().min(1).optional(),
+    checks: z.array(limnerRegionCheckSchema).default(['bounds', 'visible']),
+});
+export const limnerRegionContractSchema = z.object({
+    regions: z.array(limnerRegionSchema).default([]),
+});
+export const limnerTokensSchema = z.object({
+    colors: z.record(z.string(), z.string()).default({}),
+    radii: z.record(z.string(), z.number()).default({}),
+    typography: z.record(z.string(), z.union([z.string(), z.number()])).default({}),
+    spacing: z.record(z.string(), z.number()).default({}),
+});
+//# sourceMappingURL=contract.js.map

package/dist/schemas/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../src/schemas/contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC;AAE/F,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACzC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;CACxE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACjD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACpD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACnD,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC/E,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACtD,CAAC,CAAC"}

package/dist/schemas/events.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+export declare const limnerRunEventSchema: z.ZodObject<{
+    type: z.ZodString;
+    ts: z.ZodString;
+    command: z.ZodOptional<z.ZodString>;
+    mode: z.ZodOptional<z.ZodString>;
+    target: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    kind: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    message: z.ZodOptional<z.ZodString>;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const runManifestSchema: z.ZodObject<{
+    runId: z.ZodString;
+    command: z.ZodString;
+    target: z.ZodOptional<z.ZodString>;
+    mode: z.ZodOptional<z.ZodString>;
+    startedAt: z.ZodString;
+    completedAt: z.ZodOptional<z.ZodString>;
+    status: z.ZodDefault<z.ZodEnum<{
+        running: "running";
+        ok: "ok";
+        failed: "failed";
+    }>>;
+    artifacts: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    viewport: z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type LimnerRunEvent = z.infer<typeof limnerRunEventSchema>;
+export type RunManifest = z.infer<typeof runManifestSchema>;

package/dist/schemas/events.js

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+export const limnerRunEventSchema = z.object({
+    type: z.string().min(1),
+    ts: z.string().datetime(),
+    command: z.string().optional(),
+    mode: z.string().optional(),
+    target: z.string().optional(),
+    path: z.string().optional(),
+    kind: z.string().optional(),
+    status: z.string().optional(),
+    durationMs: z.number().optional(),
+    message: z.string().optional(),
+    data: z.record(z.string(), z.unknown()).optional(),
+});
+export const runManifestSchema = z.object({
+    runId: z.string().min(1),
+    command: z.string().min(1),
+    target: z.string().optional(),
+    mode: z.string().optional(),
+    startedAt: z.string().datetime(),
+    completedAt: z.string().datetime().optional(),
+    status: z.enum(['running', 'ok', 'failed']).default('running'),
+    artifacts: z.array(z.string()).default([]),
+    viewport: z.object({
+        width: z.number(),
+        height: z.number(),
+    }).optional(),
+});
+//# sourceMappingURL=events.js.map

package/dist/schemas/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/schemas/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACnD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC7C,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IAC9D,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC1C,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;QACjB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;KACnB,CAAC,CAAC,QAAQ,EAAE;CACd,CAAC,CAAC"}