@cappa/protocol 0.9.0 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.cjs CHANGED
@@ -30,6 +30,24 @@ const diffMetadataSchema = zod.z.object({
30
30
  */
31
31
  interpretation: zod.z.unknown().optional()
32
32
  });
33
+ /**
34
+ * The verdict `cappa agent check` reached for a changed screenshot.
35
+ *
36
+ * Unlike the interpretation this is cappa's own shape, so it is described
37
+ * rather than carried opaquely. `label` and `action` stay plain strings on the
38
+ * wire so a newer engine adding a label does not make an older client reject
39
+ * the whole screenshot list.
40
+ */
41
+ const agentReviewSchema = zod.z.object({
42
+ label: zod.z.string(),
43
+ headline: zod.z.string(),
44
+ rationale: zod.z.array(zod.z.string()),
45
+ action: zod.z.string(),
46
+ source: zod.z.enum(["heuristic", "agent"]),
47
+ confidence: zod.z.number().optional(),
48
+ pending: zod.z.boolean(),
49
+ reviewedAt: zod.z.string()
50
+ });
33
51
  const screenshotBase = {
34
52
  id: zod.z.string(),
35
53
  name: zod.z.string(),
@@ -73,7 +91,8 @@ const changedScreenshotSchema = zod.z.object({
73
91
  actualPath: zod.z.string(),
74
92
  expectedPath: zod.z.string(),
75
93
  diffPath: zod.z.string(),
76
- diffMeta: diffMetadataSchema.optional()
94
+ diffMeta: diffMetadataSchema.optional(),
95
+ review: agentReviewSchema.optional()
77
96
  });
78
97
  const passedScreenshotSchema = zod.z.object({
79
98
  ...screenshotBase,
@@ -458,6 +477,7 @@ exports.ASSET_PREFIX = ASSET_PREFIX;
458
477
  exports.ERROR_CODES = ERROR_CODES;
459
478
  exports.PROTOCOL_VERSION = PROTOCOL_VERSION;
460
479
  exports.TOKEN_HEADER = TOKEN_HEADER;
480
+ exports.agentReviewSchema = agentReviewSchema;
461
481
  exports.approveRequestSchema = approveRequestSchema;
462
482
  exports.approveResultSchema = approveResultSchema;
463
483
  exports.capabilitiesSchema = capabilitiesSchema;
@@ -1 +1 @@
1
- {"version":3,"file":"index.cjs","names":["z","z","z"],"sources":["../src/screenshot.ts","../src/routes.ts","../src/run.ts"],"sourcesContent":["import { z } from \"zod\";\n\n/**\n * Screenshot shapes as they cross the wire.\n *\n * These mirror the types in `@cappa/core`, but are declared independently on\n * purpose: this package must stay installable by a browser client that has no\n * business pulling in `playwright-core` or native diff bindings. A type-level\n * compatibility assertion in `screenshot.test.ts` fails the build if the two\n * definitions drift apart.\n */\n\nexport const screenshotCategorySchema = z.enum([\n \"new\",\n \"deleted\",\n \"changed\",\n \"passed\",\n]);\n\nexport type ScreenshotCategory = z.infer<typeof screenshotCategorySchema>;\n\nexport const diffMetadataSchema = z.object({\n numDiffPixels: z.number(),\n percentDifference: z.number(),\n /**\n * Structured diff interpretation, carried opaquely.\n *\n * Its shape is owned by the diff engine (`@blazediff/core-native`'s\n * `InterpretResult`) and changes with that dependency. Pinning it here would\n * make every diff-engine upgrade a breaking protocol change for no benefit,\n * so the protocol passes it through untouched and consumers that want to\n * render the detail narrow it with `InterpretResult` from `@cappa/core`.\n */\n interpretation: z.unknown().optional(),\n});\n\nexport type DiffMetadata = z.infer<typeof diffMetadataSchema>;\n\nconst screenshotBase = {\n id: z.string(),\n name: z.string(),\n approved: z.boolean().optional(),\n /**\n * The capture task that produced this screenshot.\n *\n * Described here because it is the only way a client can re-capture one\n * screenshot: `startRun` accepts task ids, and a screenshot's `name` is not\n * one — Storybook writes `example/button/primary` for the task\n * `example-button--primary`. Optional because the engine can only know it for\n * screenshots captured since the capture manifest existed, so a client must\n * treat its absence as \"not re-capturable\" rather than substituting `name`.\n */\n taskId: z.string().optional(),\n /** Plugin that owns `taskId`. Absent whenever `taskId` is. */\n plugin: z.string().optional(),\n /**\n * Neighbours in the full, unfiltered list, so the UI can walk every\n * screenshot with the arrow keys regardless of the current filter.\n *\n * Computed by the server rather than the engine — but they must be described\n * here, or a client parsing a response would silently drop them.\n */\n next: z.string().optional(),\n prev: z.string().optional(),\n};\n\nexport const newScreenshotSchema = z.object({\n ...screenshotBase,\n category: z.literal(\"new\"),\n actualPath: z.string(),\n});\n\nexport const deletedScreenshotSchema = z.object({\n ...screenshotBase,\n category: z.literal(\"deleted\"),\n expectedPath: z.string(),\n});\n\nexport const changedScreenshotSchema = z.object({\n ...screenshotBase,\n category: z.literal(\"changed\"),\n actualPath: z.string(),\n expectedPath: z.string(),\n diffPath: z.string(),\n diffMeta: diffMetadataSchema.optional(),\n});\n\nexport const passedScreenshotSchema = z.object({\n ...screenshotBase,\n category: z.literal(\"passed\"),\n actualPath: z.string(),\n expectedPath: z.string(),\n});\n\n/**\n * The changed variant on its own.\n *\n * Exported because the review UI's comparison views only ever render a changed\n * screenshot, and typing them on the full union would force a narrow at every\n * call site.\n */\nexport type ChangedScreenshot = z.infer<typeof changedScreenshotSchema>;\n\nexport const screenshotSchema = z.discriminatedUnion(\"category\", [\n newScreenshotSchema,\n deletedScreenshotSchema,\n changedScreenshotSchema,\n passedScreenshotSchema,\n]);\n\nexport type Screenshot = z.infer<typeof screenshotSchema>;\n\nexport const screenshotQuerySchema = z.object({\n search: z.string().optional(),\n category: screenshotCategorySchema.optional(),\n});\n\nexport type ScreenshotQuery = z.infer<typeof screenshotQuerySchema>;\n\nexport const approveRequestSchema = z.object({\n names: z.array(z.string()).min(1, \"names must be a non-empty array\"),\n});\n\nexport type ApproveRequest = z.infer<typeof approveRequestSchema>;\n\nexport const approveResultSchema = z.object({\n approved: z.array(z.string()),\n errors: z.array(z.object({ name: z.string(), error: z.string() })),\n});\n\nexport type ApproveResult = z.infer<typeof approveResultSchema>;\n","import { z } from \"zod\";\nimport { screenshotCategorySchema } from \"./screenshot\";\n\n/**\n * Bumped whenever the wire contract changes incompatibly.\n *\n * Served on `GET /api/health` and checked by `@cappa/client` on its first call,\n * so a client built against an older server fails with a clear message instead\n * of mis-parsing responses.\n */\nexport const PROTOCOL_VERSION = 1;\n\n/** Capabilities a server advertises, so a client can hide what is unavailable. */\nexport const capabilitiesSchema = z.object({\n /** Capture routes are mounted (false when the server is read-only). */\n capture: z.boolean(),\n /** Screenshots can be approved. */\n approve: z.boolean(),\n /** The run event stream is available. */\n events: z.boolean(),\n /**\n * The server can watch its own filesystem and re-capture on change.\n *\n * Optional so a client built against this version still parses an older\n * server's health response, which has no such field. Absent means no.\n */\n watch: z.boolean().optional(),\n});\n\nexport type Capabilities = z.infer<typeof capabilitiesSchema>;\n\nexport const healthResponseSchema = z.object({\n ok: z.boolean(),\n protocolVersion: z.number(),\n capabilities: capabilitiesSchema,\n});\n\nexport type HealthResponse = z.infer<typeof healthResponseSchema>;\n\nexport const configResponseSchema = z.object({\n theme: z.enum([\"light\", \"dark\"]),\n readOnly: z.boolean(),\n});\n\nexport type ConfigResponse = z.infer<typeof configResponseSchema>;\n\nexport const startRunResponseSchema = z.object({\n runId: z.string(),\n});\n\nexport type StartRunResponse = z.infer<typeof startRunResponseSchema>;\n\n/**\n * Machine-readable codes on error responses.\n *\n * Kept here, in the wire contract, rather than derived from `@cappa/core`'s\n * error classes: a client must be able to tell a conflict from a validation\n * failure without installing the engine. `@cappa/core` mirrors these values and\n * a compatibility assertion there fails the build if they drift.\n */\nexport const ERROR_CODES = {\n runInProgress: \"CAPPA_RUN_IN_PROGRESS\",\n unknownTargets: \"CAPPA_UNKNOWN_TARGETS\",\n watchInProgress: \"CAPPA_WATCH_IN_PROGRESS\",\n} as const;\n\nexport type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];\n\nexport const errorResponseSchema = z.object({\n error: z.unknown(),\n code: z.string().optional(),\n activeRunId: z.string().optional(),\n taskIds: z.array(z.string()).optional(),\n});\n\nexport type ErrorResponse = z.infer<typeof errorResponseSchema>;\n\n/** Every route the server exposes, in one place. */\nexport const routes = {\n health: \"/api/health\",\n config: \"/api/config\",\n plugins: \"/api/plugins\",\n targets: \"/api/targets\",\n runs: \"/api/runs\",\n run: (id: string) => `/api/runs/${encodeURIComponent(id)}`,\n runCancel: (id: string) => `/api/runs/${encodeURIComponent(id)}/cancel`,\n runEvents: (id: string) => `/api/runs/${encodeURIComponent(id)}/events`,\n screenshots: \"/api/screenshots\",\n screenshot: (id: string) => `/api/screenshots/${encodeURIComponent(id)}`,\n approveBatch: \"/api/screenshots/approve-batch\",\n watch: \"/api/watch\",\n watchEvents: \"/api/watch/events\",\n} as const;\n\n/** Prefix under which screenshot images are served. */\nexport const ASSET_PREFIX = \"/assets/screenshots\";\n\n/** Header carrying the access token when the server is not on loopback. */\nexport const TOKEN_HEADER = \"x-cappa-token\";\n\nexport const targetsQuerySchema = z.object({\n refresh: z\n .union([\n z.literal(\"1\"),\n z.literal(\"true\"),\n z.literal(\"0\"),\n z.literal(\"false\"),\n ])\n .optional(),\n});\n\nexport { screenshotCategorySchema };\n","import { z } from \"zod\";\n\nexport const runStateSchema = z.enum([\n \"idle\",\n \"discovering\",\n \"running\",\n \"completed\",\n \"failed\",\n \"cancelled\",\n]);\n\nexport type RunState = z.infer<typeof runStateSchema>;\n\nexport const taskStatusSchema = z.enum([\n \"pending\",\n \"running\",\n \"passed\",\n \"changed\",\n \"new\",\n \"failed\",\n \"skipped\",\n]);\n\nexport type TaskStatus = z.infer<typeof taskStatusSchema>;\n\nexport const targetSchema = z.object({\n id: z.string(),\n url: z.string(),\n plugin: z.string(),\n});\n\nexport type Target = z.infer<typeof targetSchema>;\n\nexport const pluginInfoSchema = z.object({\n name: z.string(),\n description: z.string().optional(),\n});\n\nexport type PluginInfo = z.infer<typeof pluginInfoSchema>;\n\n/**\n * Why a run started, when a person did not start it.\n *\n * Carried on the request rather than as a separate lookup, so a run list can\n * say \"this one came from saving Button.stories.tsx\" from what it already has.\n */\nexport const runTriggerSchema = z.object({\n source: z.literal(\"watch\"),\n files: z.array(z.string()),\n});\n\nexport type RunTrigger = z.infer<typeof runTriggerSchema>;\n\nexport const startRunRequestSchema = z.object({\n plugins: z.array(z.string()).optional(),\n filter: z.string().optional(),\n taskIds: z.array(z.string()).optional(),\n clearActual: z.boolean().optional(),\n trigger: runTriggerSchema.optional(),\n});\n\nexport type StartRunRequest = z.infer<typeof startRunRequestSchema>;\n\nexport const serializedErrorSchema = z.object({\n name: z.string(),\n message: z.string(),\n stack: z.string().optional(),\n});\n\nexport type SerializedError = z.infer<typeof serializedErrorSchema>;\n\n/**\n * A plugin's `execute` return value.\n *\n * Only the keys the runner interprets are named; plugins are free to return\n * more, so unknown keys pass through.\n */\nexport const pluginCaptureResultSchema = z.looseObject({\n success: z.boolean().optional(),\n skipped: z.boolean().optional(),\n isNew: z.boolean().optional(),\n error: z.unknown().optional(),\n filepath: z.string().optional(),\n storyId: z.string().optional(),\n storyName: z.string().optional(),\n});\n\nexport type PluginCaptureResult = z.infer<typeof pluginCaptureResultSchema>;\n\nexport const taskFailureSchema = z.object({\n taskId: z.string(),\n taskUrl: z.string(),\n pluginName: z.string(),\n result: pluginCaptureResultSchema,\n});\n\nexport type TaskFailure = z.infer<typeof taskFailureSchema>;\n\nexport const taskRecordSchema = z.object({\n id: z.string(),\n url: z.string(),\n plugin: z.string(),\n status: taskStatusSchema,\n durationMs: z.number().optional(),\n result: pluginCaptureResultSchema.optional(),\n});\n\nexport type TaskRecord = z.infer<typeof taskRecordSchema>;\n\nexport const runSummarySchema = z.object({\n id: z.string(),\n state: runStateSchema,\n request: startRunRequestSchema,\n startedAt: z.number(),\n finishedAt: z.number().optional(),\n durationMs: z.number().optional(),\n totalTasks: z.number(),\n completedTasks: z.number(),\n failedTasks: z.number(),\n deletedScreenshots: z.array(z.string()),\n anyTasksRan: z.boolean(),\n error: serializedErrorSchema.optional(),\n});\n\nexport type RunSummary = z.infer<typeof runSummarySchema>;\n\nexport const runDetailSchema = runSummarySchema.extend({\n tasks: z.array(taskRecordSchema),\n failures: z.array(taskFailureSchema),\n});\n\nexport type RunDetail = z.infer<typeof runDetailSchema>;\n\nexport const runLogLevelSchema = z.enum([\n \"debug\",\n \"info\",\n \"warn\",\n \"error\",\n \"success\",\n]);\n\nexport type RunLogLevel = z.infer<typeof runLogLevelSchema>;\n\nconst eventBase = {\n seq: z.number(),\n runId: z.string(),\n at: z.number(),\n};\n\n/**\n * The run event stream, exactly as `@cappa/core`'s `CaptureRunner` emits it.\n *\n * `seq` is monotonic and 1-based per run; the SSE endpoint uses it as the\n * `Last-Event-ID` so a reconnecting client can replay what it missed.\n */\nexport const runEventSchema = z.discriminatedUnion(\"type\", [\n z.object({\n ...eventBase,\n type: z.literal(\"run:start\"),\n request: startRunRequestSchema,\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"discover:start\"),\n plugins: z.array(z.string()),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"discover:plugin\"),\n plugin: z.string(),\n taskCount: z.number(),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"discover:complete\"),\n targets: z.array(targetSchema),\n totalTasks: z.number(),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"filter:applied\"),\n filter: z.string().optional(),\n taskIds: z.array(z.string()).optional(),\n plugins: z.array(\n z.object({\n plugin: z.string(),\n before: z.number(),\n after: z.number(),\n }),\n ),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"plugin:start\"),\n plugin: z.string(),\n taskCount: z.number(),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"task:start\"),\n plugin: z.string(),\n taskId: z.string(),\n url: z.string(),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"task:complete\"),\n plugin: z.string(),\n taskId: z.string(),\n url: z.string(),\n status: taskStatusSchema,\n completed: z.number(),\n total: z.number(),\n durationMs: z.number(),\n result: pluginCaptureResultSchema.optional(),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"plugin:complete\"),\n plugin: z.string(),\n resultCount: z.number(),\n failed: z.boolean(),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"log\"),\n level: runLogLevelSchema,\n message: z.string(),\n args: z.array(z.unknown()),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"run:complete\"),\n summary: runSummarySchema,\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"run:error\"),\n error: serializedErrorSchema,\n }),\n z.object({ ...eventBase, type: z.literal(\"run:cancelled\") }),\n]);\n\nexport type RunEvent = z.infer<typeof runEventSchema>;\n\nexport type RunEventType = RunEvent[\"type\"];\n\n/**\n * How a watch iteration decided what to capture.\n *\n * `tasks` is the precise case; `plugins` means at least one plugin could not\n * attribute the change; `all` means the resolved set was too large or discovery\n * failed; `none` means there was nothing to capture.\n */\nexport const watchScopeSchema = z.enum([\"tasks\", \"plugins\", \"all\", \"none\"]);\n\nexport type WatchScope = z.infer<typeof watchScopeSchema>;\n\nexport const watchChangeSchema = z.object({\n files: z.array(z.string()),\n scope: watchScopeSchema,\n taskIds: z.array(z.string()).optional(),\n runId: z.string().optional(),\n error: z.string().optional(),\n at: z.number(),\n});\n\nexport type WatchChange = z.infer<typeof watchChangeSchema>;\n\nconst watchEventBase = {\n /** Monotonic, 1-based, per server. Used for SSE `Last-Event-ID` replay. */\n seq: z.number(),\n at: z.number(),\n};\n\n/**\n * The watch event stream, exactly as `@cappa/core`'s engine emits it.\n *\n * Separate from `runEventSchema` because a watch session outlives any single\n * run: the runs it starts report themselves on the ordinary run stream, and\n * these events say why they started.\n */\nexport const watchEventSchema = z.discriminatedUnion(\"type\", [\n z.object({\n ...watchEventBase,\n type: z.literal(\"watch:start\"),\n paths: z.array(z.string()),\n filter: z.string().optional(),\n debounceMs: z.number(),\n }),\n z.object({\n ...watchEventBase,\n type: z.literal(\"watch:change\"),\n files: z.array(z.string()),\n scope: watchScopeSchema,\n taskIds: z.array(z.string()).optional(),\n runId: z.string().optional(),\n error: z.string().optional(),\n }),\n z.object({\n ...watchEventBase,\n type: z.literal(\"watch:stop\"),\n reason: z.enum([\"requested\", \"engine-closed\"]),\n }),\n]);\n\nexport type WatchEvent = z.infer<typeof watchEventSchema>;\n\nexport type WatchEventType = WatchEvent[\"type\"];\n\nexport const watchStatusSchema = z.object({\n active: z.boolean(),\n paths: z.array(z.string()),\n filter: z.string().optional(),\n debounceMs: z.number(),\n startedAt: z.number().optional(),\n lastChange: watchChangeSchema.optional(),\n});\n\nexport type WatchStatus = z.infer<typeof watchStatusSchema>;\n\nexport const startWatchRequestSchema = z.object({\n paths: z.array(z.string()).optional(),\n filter: z.string().optional(),\n debounceMs: z.number().optional(),\n maxTasks: z.number().optional(),\n});\n\nexport type StartWatchRequest = z.infer<typeof startWatchRequestSchema>;\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.cjs","names":["z","z","z"],"sources":["../src/screenshot.ts","../src/routes.ts","../src/run.ts"],"sourcesContent":["import { z } from \"zod\";\n\n/**\n * Screenshot shapes as they cross the wire.\n *\n * These mirror the types in `@cappa/core`, but are declared independently on\n * purpose: this package must stay installable by a browser client that has no\n * business pulling in `playwright-core` or native diff bindings. A type-level\n * compatibility assertion in `screenshot.test.ts` fails the build if the two\n * definitions drift apart.\n */\n\nexport const screenshotCategorySchema = z.enum([\n \"new\",\n \"deleted\",\n \"changed\",\n \"passed\",\n]);\n\nexport type ScreenshotCategory = z.infer<typeof screenshotCategorySchema>;\n\nexport const diffMetadataSchema = z.object({\n numDiffPixels: z.number(),\n percentDifference: z.number(),\n /**\n * Structured diff interpretation, carried opaquely.\n *\n * Its shape is owned by the diff engine (`@blazediff/core-native`'s\n * `InterpretResult`) and changes with that dependency. Pinning it here would\n * make every diff-engine upgrade a breaking protocol change for no benefit,\n * so the protocol passes it through untouched and consumers that want to\n * render the detail narrow it with `InterpretResult` from `@cappa/core`.\n */\n interpretation: z.unknown().optional(),\n});\n\nexport type DiffMetadata = z.infer<typeof diffMetadataSchema>;\n\n/**\n * The verdict `cappa agent check` reached for a changed screenshot.\n *\n * Unlike the interpretation this is cappa's own shape, so it is described\n * rather than carried opaquely. `label` and `action` stay plain strings on the\n * wire so a newer engine adding a label does not make an older client reject\n * the whole screenshot list.\n */\nexport const agentReviewSchema = z.object({\n label: z.string(),\n headline: z.string(),\n rationale: z.array(z.string()),\n action: z.string(),\n source: z.enum([\"heuristic\", \"agent\"]),\n confidence: z.number().optional(),\n pending: z.boolean(),\n reviewedAt: z.string(),\n});\n\nexport type AgentReview = z.infer<typeof agentReviewSchema>;\n\nconst screenshotBase = {\n id: z.string(),\n name: z.string(),\n approved: z.boolean().optional(),\n /**\n * The capture task that produced this screenshot.\n *\n * Described here because it is the only way a client can re-capture one\n * screenshot: `startRun` accepts task ids, and a screenshot's `name` is not\n * one — Storybook writes `example/button/primary` for the task\n * `example-button--primary`. Optional because the engine can only know it for\n * screenshots captured since the capture manifest existed, so a client must\n * treat its absence as \"not re-capturable\" rather than substituting `name`.\n */\n taskId: z.string().optional(),\n /** Plugin that owns `taskId`. Absent whenever `taskId` is. */\n plugin: z.string().optional(),\n /**\n * Neighbours in the full, unfiltered list, so the UI can walk every\n * screenshot with the arrow keys regardless of the current filter.\n *\n * Computed by the server rather than the engine — but they must be described\n * here, or a client parsing a response would silently drop them.\n */\n next: z.string().optional(),\n prev: z.string().optional(),\n};\n\nexport const newScreenshotSchema = z.object({\n ...screenshotBase,\n category: z.literal(\"new\"),\n actualPath: z.string(),\n});\n\nexport const deletedScreenshotSchema = z.object({\n ...screenshotBase,\n category: z.literal(\"deleted\"),\n expectedPath: z.string(),\n});\n\nexport const changedScreenshotSchema = z.object({\n ...screenshotBase,\n category: z.literal(\"changed\"),\n actualPath: z.string(),\n expectedPath: z.string(),\n diffPath: z.string(),\n diffMeta: diffMetadataSchema.optional(),\n review: agentReviewSchema.optional(),\n});\n\nexport const passedScreenshotSchema = z.object({\n ...screenshotBase,\n category: z.literal(\"passed\"),\n actualPath: z.string(),\n expectedPath: z.string(),\n});\n\n/**\n * The changed variant on its own.\n *\n * Exported because the review UI's comparison views only ever render a changed\n * screenshot, and typing them on the full union would force a narrow at every\n * call site.\n */\nexport type ChangedScreenshot = z.infer<typeof changedScreenshotSchema>;\n\nexport const screenshotSchema = z.discriminatedUnion(\"category\", [\n newScreenshotSchema,\n deletedScreenshotSchema,\n changedScreenshotSchema,\n passedScreenshotSchema,\n]);\n\nexport type Screenshot = z.infer<typeof screenshotSchema>;\n\nexport const screenshotQuerySchema = z.object({\n search: z.string().optional(),\n category: screenshotCategorySchema.optional(),\n});\n\nexport type ScreenshotQuery = z.infer<typeof screenshotQuerySchema>;\n\nexport const approveRequestSchema = z.object({\n names: z.array(z.string()).min(1, \"names must be a non-empty array\"),\n});\n\nexport type ApproveRequest = z.infer<typeof approveRequestSchema>;\n\nexport const approveResultSchema = z.object({\n approved: z.array(z.string()),\n errors: z.array(z.object({ name: z.string(), error: z.string() })),\n});\n\nexport type ApproveResult = z.infer<typeof approveResultSchema>;\n","import { z } from \"zod\";\nimport { screenshotCategorySchema } from \"./screenshot\";\n\n/**\n * Bumped whenever the wire contract changes incompatibly.\n *\n * Served on `GET /api/health` and checked by `@cappa/client` on its first call,\n * so a client built against an older server fails with a clear message instead\n * of mis-parsing responses.\n */\nexport const PROTOCOL_VERSION = 1;\n\n/** Capabilities a server advertises, so a client can hide what is unavailable. */\nexport const capabilitiesSchema = z.object({\n /** Capture routes are mounted (false when the server is read-only). */\n capture: z.boolean(),\n /** Screenshots can be approved. */\n approve: z.boolean(),\n /** The run event stream is available. */\n events: z.boolean(),\n /**\n * The server can watch its own filesystem and re-capture on change.\n *\n * Optional so a client built against this version still parses an older\n * server's health response, which has no such field. Absent means no.\n */\n watch: z.boolean().optional(),\n});\n\nexport type Capabilities = z.infer<typeof capabilitiesSchema>;\n\nexport const healthResponseSchema = z.object({\n ok: z.boolean(),\n protocolVersion: z.number(),\n capabilities: capabilitiesSchema,\n});\n\nexport type HealthResponse = z.infer<typeof healthResponseSchema>;\n\nexport const configResponseSchema = z.object({\n theme: z.enum([\"light\", \"dark\"]),\n readOnly: z.boolean(),\n});\n\nexport type ConfigResponse = z.infer<typeof configResponseSchema>;\n\nexport const startRunResponseSchema = z.object({\n runId: z.string(),\n});\n\nexport type StartRunResponse = z.infer<typeof startRunResponseSchema>;\n\n/**\n * Machine-readable codes on error responses.\n *\n * Kept here, in the wire contract, rather than derived from `@cappa/core`'s\n * error classes: a client must be able to tell a conflict from a validation\n * failure without installing the engine. `@cappa/core` mirrors these values and\n * a compatibility assertion there fails the build if they drift.\n */\nexport const ERROR_CODES = {\n runInProgress: \"CAPPA_RUN_IN_PROGRESS\",\n unknownTargets: \"CAPPA_UNKNOWN_TARGETS\",\n watchInProgress: \"CAPPA_WATCH_IN_PROGRESS\",\n} as const;\n\nexport type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];\n\nexport const errorResponseSchema = z.object({\n error: z.unknown(),\n code: z.string().optional(),\n activeRunId: z.string().optional(),\n taskIds: z.array(z.string()).optional(),\n});\n\nexport type ErrorResponse = z.infer<typeof errorResponseSchema>;\n\n/** Every route the server exposes, in one place. */\nexport const routes = {\n health: \"/api/health\",\n config: \"/api/config\",\n plugins: \"/api/plugins\",\n targets: \"/api/targets\",\n runs: \"/api/runs\",\n run: (id: string) => `/api/runs/${encodeURIComponent(id)}`,\n runCancel: (id: string) => `/api/runs/${encodeURIComponent(id)}/cancel`,\n runEvents: (id: string) => `/api/runs/${encodeURIComponent(id)}/events`,\n screenshots: \"/api/screenshots\",\n screenshot: (id: string) => `/api/screenshots/${encodeURIComponent(id)}`,\n approveBatch: \"/api/screenshots/approve-batch\",\n watch: \"/api/watch\",\n watchEvents: \"/api/watch/events\",\n} as const;\n\n/** Prefix under which screenshot images are served. */\nexport const ASSET_PREFIX = \"/assets/screenshots\";\n\n/** Header carrying the access token when the server is not on loopback. */\nexport const TOKEN_HEADER = \"x-cappa-token\";\n\nexport const targetsQuerySchema = z.object({\n refresh: z\n .union([\n z.literal(\"1\"),\n z.literal(\"true\"),\n z.literal(\"0\"),\n z.literal(\"false\"),\n ])\n .optional(),\n});\n\nexport { screenshotCategorySchema };\n","import { z } from \"zod\";\n\nexport const runStateSchema = z.enum([\n \"idle\",\n \"discovering\",\n \"running\",\n \"completed\",\n \"failed\",\n \"cancelled\",\n]);\n\nexport type RunState = z.infer<typeof runStateSchema>;\n\nexport const taskStatusSchema = z.enum([\n \"pending\",\n \"running\",\n \"passed\",\n \"changed\",\n \"new\",\n \"failed\",\n \"skipped\",\n]);\n\nexport type TaskStatus = z.infer<typeof taskStatusSchema>;\n\nexport const targetSchema = z.object({\n id: z.string(),\n url: z.string(),\n plugin: z.string(),\n});\n\nexport type Target = z.infer<typeof targetSchema>;\n\nexport const pluginInfoSchema = z.object({\n name: z.string(),\n description: z.string().optional(),\n});\n\nexport type PluginInfo = z.infer<typeof pluginInfoSchema>;\n\n/**\n * Why a run started, when a person did not start it.\n *\n * Carried on the request rather than as a separate lookup, so a run list can\n * say \"this one came from saving Button.stories.tsx\" from what it already has.\n */\nexport const runTriggerSchema = z.object({\n source: z.literal(\"watch\"),\n files: z.array(z.string()),\n});\n\nexport type RunTrigger = z.infer<typeof runTriggerSchema>;\n\nexport const startRunRequestSchema = z.object({\n plugins: z.array(z.string()).optional(),\n filter: z.string().optional(),\n taskIds: z.array(z.string()).optional(),\n clearActual: z.boolean().optional(),\n trigger: runTriggerSchema.optional(),\n});\n\nexport type StartRunRequest = z.infer<typeof startRunRequestSchema>;\n\nexport const serializedErrorSchema = z.object({\n name: z.string(),\n message: z.string(),\n stack: z.string().optional(),\n});\n\nexport type SerializedError = z.infer<typeof serializedErrorSchema>;\n\n/**\n * A plugin's `execute` return value.\n *\n * Only the keys the runner interprets are named; plugins are free to return\n * more, so unknown keys pass through.\n */\nexport const pluginCaptureResultSchema = z.looseObject({\n success: z.boolean().optional(),\n skipped: z.boolean().optional(),\n isNew: z.boolean().optional(),\n error: z.unknown().optional(),\n filepath: z.string().optional(),\n storyId: z.string().optional(),\n storyName: z.string().optional(),\n});\n\nexport type PluginCaptureResult = z.infer<typeof pluginCaptureResultSchema>;\n\nexport const taskFailureSchema = z.object({\n taskId: z.string(),\n taskUrl: z.string(),\n pluginName: z.string(),\n result: pluginCaptureResultSchema,\n});\n\nexport type TaskFailure = z.infer<typeof taskFailureSchema>;\n\nexport const taskRecordSchema = z.object({\n id: z.string(),\n url: z.string(),\n plugin: z.string(),\n status: taskStatusSchema,\n durationMs: z.number().optional(),\n result: pluginCaptureResultSchema.optional(),\n});\n\nexport type TaskRecord = z.infer<typeof taskRecordSchema>;\n\nexport const runSummarySchema = z.object({\n id: z.string(),\n state: runStateSchema,\n request: startRunRequestSchema,\n startedAt: z.number(),\n finishedAt: z.number().optional(),\n durationMs: z.number().optional(),\n totalTasks: z.number(),\n completedTasks: z.number(),\n failedTasks: z.number(),\n deletedScreenshots: z.array(z.string()),\n anyTasksRan: z.boolean(),\n error: serializedErrorSchema.optional(),\n});\n\nexport type RunSummary = z.infer<typeof runSummarySchema>;\n\nexport const runDetailSchema = runSummarySchema.extend({\n tasks: z.array(taskRecordSchema),\n failures: z.array(taskFailureSchema),\n});\n\nexport type RunDetail = z.infer<typeof runDetailSchema>;\n\nexport const runLogLevelSchema = z.enum([\n \"debug\",\n \"info\",\n \"warn\",\n \"error\",\n \"success\",\n]);\n\nexport type RunLogLevel = z.infer<typeof runLogLevelSchema>;\n\nconst eventBase = {\n seq: z.number(),\n runId: z.string(),\n at: z.number(),\n};\n\n/**\n * The run event stream, exactly as `@cappa/core`'s `CaptureRunner` emits it.\n *\n * `seq` is monotonic and 1-based per run; the SSE endpoint uses it as the\n * `Last-Event-ID` so a reconnecting client can replay what it missed.\n */\nexport const runEventSchema = z.discriminatedUnion(\"type\", [\n z.object({\n ...eventBase,\n type: z.literal(\"run:start\"),\n request: startRunRequestSchema,\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"discover:start\"),\n plugins: z.array(z.string()),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"discover:plugin\"),\n plugin: z.string(),\n taskCount: z.number(),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"discover:complete\"),\n targets: z.array(targetSchema),\n totalTasks: z.number(),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"filter:applied\"),\n filter: z.string().optional(),\n taskIds: z.array(z.string()).optional(),\n plugins: z.array(\n z.object({\n plugin: z.string(),\n before: z.number(),\n after: z.number(),\n }),\n ),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"plugin:start\"),\n plugin: z.string(),\n taskCount: z.number(),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"task:start\"),\n plugin: z.string(),\n taskId: z.string(),\n url: z.string(),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"task:complete\"),\n plugin: z.string(),\n taskId: z.string(),\n url: z.string(),\n status: taskStatusSchema,\n completed: z.number(),\n total: z.number(),\n durationMs: z.number(),\n result: pluginCaptureResultSchema.optional(),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"plugin:complete\"),\n plugin: z.string(),\n resultCount: z.number(),\n failed: z.boolean(),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"log\"),\n level: runLogLevelSchema,\n message: z.string(),\n args: z.array(z.unknown()),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"run:complete\"),\n summary: runSummarySchema,\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"run:error\"),\n error: serializedErrorSchema,\n }),\n z.object({ ...eventBase, type: z.literal(\"run:cancelled\") }),\n]);\n\nexport type RunEvent = z.infer<typeof runEventSchema>;\n\nexport type RunEventType = RunEvent[\"type\"];\n\n/**\n * How a watch iteration decided what to capture.\n *\n * `tasks` is the precise case; `plugins` means at least one plugin could not\n * attribute the change; `all` means the resolved set was too large or discovery\n * failed; `none` means there was nothing to capture.\n */\nexport const watchScopeSchema = z.enum([\"tasks\", \"plugins\", \"all\", \"none\"]);\n\nexport type WatchScope = z.infer<typeof watchScopeSchema>;\n\nexport const watchChangeSchema = z.object({\n files: z.array(z.string()),\n scope: watchScopeSchema,\n taskIds: z.array(z.string()).optional(),\n runId: z.string().optional(),\n error: z.string().optional(),\n at: z.number(),\n});\n\nexport type WatchChange = z.infer<typeof watchChangeSchema>;\n\nconst watchEventBase = {\n /** Monotonic, 1-based, per server. Used for SSE `Last-Event-ID` replay. */\n seq: z.number(),\n at: z.number(),\n};\n\n/**\n * The watch event stream, exactly as `@cappa/core`'s engine emits it.\n *\n * Separate from `runEventSchema` because a watch session outlives any single\n * run: the runs it starts report themselves on the ordinary run stream, and\n * these events say why they started.\n */\nexport const watchEventSchema = z.discriminatedUnion(\"type\", [\n z.object({\n ...watchEventBase,\n type: z.literal(\"watch:start\"),\n paths: z.array(z.string()),\n filter: z.string().optional(),\n debounceMs: z.number(),\n }),\n z.object({\n ...watchEventBase,\n type: z.literal(\"watch:change\"),\n files: z.array(z.string()),\n scope: watchScopeSchema,\n taskIds: z.array(z.string()).optional(),\n runId: z.string().optional(),\n error: z.string().optional(),\n }),\n z.object({\n ...watchEventBase,\n type: z.literal(\"watch:stop\"),\n reason: z.enum([\"requested\", \"engine-closed\"]),\n }),\n]);\n\nexport type WatchEvent = z.infer<typeof watchEventSchema>;\n\nexport type WatchEventType = WatchEvent[\"type\"];\n\nexport const watchStatusSchema = z.object({\n active: z.boolean(),\n paths: z.array(z.string()),\n filter: z.string().optional(),\n debounceMs: z.number(),\n startedAt: z.number().optional(),\n lastChange: watchChangeSchema.optional(),\n});\n\nexport type WatchStatus = z.infer<typeof watchStatusSchema>;\n\nexport const startWatchRequestSchema = z.object({\n paths: z.array(z.string()).optional(),\n filter: z.string().optional(),\n debounceMs: z.number().optional(),\n maxTasks: z.number().optional(),\n});\n\nexport type StartWatchRequest = z.infer<typeof startWatchRequestSchema>;\n"],"mappings":"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"}
package/dist/index.d.cts CHANGED
@@ -22,6 +22,28 @@ export declare const diffMetadataSchema: z.ZodObject<{
22
22
  interpretation: z.ZodOptional<z.ZodUnknown>;
23
23
  }, z.core.$strip>;
24
24
  type DiffMetadata = z.infer<typeof diffMetadataSchema>;
25
+ /**
26
+ * The verdict `cappa agent check` reached for a changed screenshot.
27
+ *
28
+ * Unlike the interpretation this is cappa's own shape, so it is described
29
+ * rather than carried opaquely. `label` and `action` stay plain strings on the
30
+ * wire so a newer engine adding a label does not make an older client reject
31
+ * the whole screenshot list.
32
+ */
33
+ export declare const agentReviewSchema: z.ZodObject<{
34
+ label: z.ZodString;
35
+ headline: z.ZodString;
36
+ rationale: z.ZodArray<z.ZodString>;
37
+ action: z.ZodString;
38
+ source: z.ZodEnum<{
39
+ agent: "agent";
40
+ heuristic: "heuristic";
41
+ }>;
42
+ confidence: z.ZodOptional<z.ZodNumber>;
43
+ pending: z.ZodBoolean;
44
+ reviewedAt: z.ZodString;
45
+ }, z.core.$strip>;
46
+ type AgentReview = z.infer<typeof agentReviewSchema>;
25
47
  export declare const newScreenshotSchema: z.ZodObject<{
26
48
  id: z.ZodString;
27
49
  name: z.ZodString;
@@ -61,6 +83,19 @@ export declare const changedScreenshotSchema: z.ZodObject<{
61
83
  percentDifference: z.ZodNumber;
62
84
  interpretation: z.ZodOptional<z.ZodUnknown>;
63
85
  }, z.core.$strip>>;
86
+ review: z.ZodOptional<z.ZodObject<{
87
+ label: z.ZodString;
88
+ headline: z.ZodString;
89
+ rationale: z.ZodArray<z.ZodString>;
90
+ action: z.ZodString;
91
+ source: z.ZodEnum<{
92
+ agent: "agent";
93
+ heuristic: "heuristic";
94
+ }>;
95
+ confidence: z.ZodOptional<z.ZodNumber>;
96
+ pending: z.ZodBoolean;
97
+ reviewedAt: z.ZodString;
98
+ }, z.core.$strip>>;
64
99
  }, z.core.$strip>;
65
100
  export declare const passedScreenshotSchema: z.ZodObject<{
66
101
  id: z.ZodString;
@@ -119,6 +154,19 @@ export declare const screenshotSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
119
154
  percentDifference: z.ZodNumber;
120
155
  interpretation: z.ZodOptional<z.ZodUnknown>;
121
156
  }, z.core.$strip>>;
157
+ review: z.ZodOptional<z.ZodObject<{
158
+ label: z.ZodString;
159
+ headline: z.ZodString;
160
+ rationale: z.ZodArray<z.ZodString>;
161
+ action: z.ZodString;
162
+ source: z.ZodEnum<{
163
+ agent: "agent";
164
+ heuristic: "heuristic";
165
+ }>;
166
+ confidence: z.ZodOptional<z.ZodNumber>;
167
+ pending: z.ZodBoolean;
168
+ reviewedAt: z.ZodString;
169
+ }, z.core.$strip>>;
122
170
  }, z.core.$strip>, z.ZodObject<{
123
171
  id: z.ZodString;
124
172
  name: z.ZodString;
@@ -747,5 +795,5 @@ export declare const startWatchRequestSchema: z.ZodObject<{
747
795
  }, z.core.$strip>;
748
796
  type StartWatchRequest = z.infer<typeof startWatchRequestSchema>;
749
797
  //#endregion
750
- export type { ApproveRequest, ApproveResult, Capabilities, ChangedScreenshot, ConfigResponse, DiffMetadata, ErrorCode, ErrorResponse, HealthResponse, PluginCaptureResult, PluginInfo, RunDetail, RunEvent, RunEventType, RunLogLevel, RunState, RunSummary, RunTrigger, Screenshot, ScreenshotCategory, ScreenshotQuery, SerializedError, StartRunRequest, StartRunResponse, StartWatchRequest, Target, TaskFailure, TaskRecord, TaskStatus, WatchChange, WatchEvent, WatchEventType, WatchScope, WatchStatus };
798
+ export type { AgentReview, ApproveRequest, ApproveResult, Capabilities, ChangedScreenshot, ConfigResponse, DiffMetadata, ErrorCode, ErrorResponse, HealthResponse, PluginCaptureResult, PluginInfo, RunDetail, RunEvent, RunEventType, RunLogLevel, RunState, RunSummary, RunTrigger, Screenshot, ScreenshotCategory, ScreenshotQuery, SerializedError, StartRunRequest, StartRunResponse, StartWatchRequest, Target, TaskFailure, TaskRecord, TaskStatus, WatchChange, WatchEvent, WatchEventType, WatchScope, WatchStatus };
751
799
  //# sourceMappingURL=index.d.cts.map
package/dist/index.d.ts CHANGED
@@ -22,6 +22,28 @@ export declare const diffMetadataSchema: z.ZodObject<{
22
22
  interpretation: z.ZodOptional<z.ZodUnknown>;
23
23
  }, z.core.$strip>;
24
24
  type DiffMetadata = z.infer<typeof diffMetadataSchema>;
25
+ /**
26
+ * The verdict `cappa agent check` reached for a changed screenshot.
27
+ *
28
+ * Unlike the interpretation this is cappa's own shape, so it is described
29
+ * rather than carried opaquely. `label` and `action` stay plain strings on the
30
+ * wire so a newer engine adding a label does not make an older client reject
31
+ * the whole screenshot list.
32
+ */
33
+ export declare const agentReviewSchema: z.ZodObject<{
34
+ label: z.ZodString;
35
+ headline: z.ZodString;
36
+ rationale: z.ZodArray<z.ZodString>;
37
+ action: z.ZodString;
38
+ source: z.ZodEnum<{
39
+ agent: "agent";
40
+ heuristic: "heuristic";
41
+ }>;
42
+ confidence: z.ZodOptional<z.ZodNumber>;
43
+ pending: z.ZodBoolean;
44
+ reviewedAt: z.ZodString;
45
+ }, z.core.$strip>;
46
+ type AgentReview = z.infer<typeof agentReviewSchema>;
25
47
  export declare const newScreenshotSchema: z.ZodObject<{
26
48
  id: z.ZodString;
27
49
  name: z.ZodString;
@@ -61,6 +83,19 @@ export declare const changedScreenshotSchema: z.ZodObject<{
61
83
  percentDifference: z.ZodNumber;
62
84
  interpretation: z.ZodOptional<z.ZodUnknown>;
63
85
  }, z.core.$strip>>;
86
+ review: z.ZodOptional<z.ZodObject<{
87
+ label: z.ZodString;
88
+ headline: z.ZodString;
89
+ rationale: z.ZodArray<z.ZodString>;
90
+ action: z.ZodString;
91
+ source: z.ZodEnum<{
92
+ agent: "agent";
93
+ heuristic: "heuristic";
94
+ }>;
95
+ confidence: z.ZodOptional<z.ZodNumber>;
96
+ pending: z.ZodBoolean;
97
+ reviewedAt: z.ZodString;
98
+ }, z.core.$strip>>;
64
99
  }, z.core.$strip>;
65
100
  export declare const passedScreenshotSchema: z.ZodObject<{
66
101
  id: z.ZodString;
@@ -119,6 +154,19 @@ export declare const screenshotSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
119
154
  percentDifference: z.ZodNumber;
120
155
  interpretation: z.ZodOptional<z.ZodUnknown>;
121
156
  }, z.core.$strip>>;
157
+ review: z.ZodOptional<z.ZodObject<{
158
+ label: z.ZodString;
159
+ headline: z.ZodString;
160
+ rationale: z.ZodArray<z.ZodString>;
161
+ action: z.ZodString;
162
+ source: z.ZodEnum<{
163
+ agent: "agent";
164
+ heuristic: "heuristic";
165
+ }>;
166
+ confidence: z.ZodOptional<z.ZodNumber>;
167
+ pending: z.ZodBoolean;
168
+ reviewedAt: z.ZodString;
169
+ }, z.core.$strip>>;
122
170
  }, z.core.$strip>, z.ZodObject<{
123
171
  id: z.ZodString;
124
172
  name: z.ZodString;
@@ -747,5 +795,5 @@ export declare const startWatchRequestSchema: z.ZodObject<{
747
795
  }, z.core.$strip>;
748
796
  type StartWatchRequest = z.infer<typeof startWatchRequestSchema>;
749
797
  //#endregion
750
- export type { ApproveRequest, ApproveResult, Capabilities, ChangedScreenshot, ConfigResponse, DiffMetadata, ErrorCode, ErrorResponse, HealthResponse, PluginCaptureResult, PluginInfo, RunDetail, RunEvent, RunEventType, RunLogLevel, RunState, RunSummary, RunTrigger, Screenshot, ScreenshotCategory, ScreenshotQuery, SerializedError, StartRunRequest, StartRunResponse, StartWatchRequest, Target, TaskFailure, TaskRecord, TaskStatus, WatchChange, WatchEvent, WatchEventType, WatchScope, WatchStatus };
798
+ export type { AgentReview, ApproveRequest, ApproveResult, Capabilities, ChangedScreenshot, ConfigResponse, DiffMetadata, ErrorCode, ErrorResponse, HealthResponse, PluginCaptureResult, PluginInfo, RunDetail, RunEvent, RunEventType, RunLogLevel, RunState, RunSummary, RunTrigger, Screenshot, ScreenshotCategory, ScreenshotQuery, SerializedError, StartRunRequest, StartRunResponse, StartWatchRequest, Target, TaskFailure, TaskRecord, TaskStatus, WatchChange, WatchEvent, WatchEventType, WatchScope, WatchStatus };
751
799
  //# sourceMappingURL=index.d.ts.map
package/dist/index.js CHANGED
@@ -29,6 +29,24 @@ const diffMetadataSchema = z.object({
29
29
  */
30
30
  interpretation: z.unknown().optional()
31
31
  });
32
+ /**
33
+ * The verdict `cappa agent check` reached for a changed screenshot.
34
+ *
35
+ * Unlike the interpretation this is cappa's own shape, so it is described
36
+ * rather than carried opaquely. `label` and `action` stay plain strings on the
37
+ * wire so a newer engine adding a label does not make an older client reject
38
+ * the whole screenshot list.
39
+ */
40
+ const agentReviewSchema = z.object({
41
+ label: z.string(),
42
+ headline: z.string(),
43
+ rationale: z.array(z.string()),
44
+ action: z.string(),
45
+ source: z.enum(["heuristic", "agent"]),
46
+ confidence: z.number().optional(),
47
+ pending: z.boolean(),
48
+ reviewedAt: z.string()
49
+ });
32
50
  const screenshotBase = {
33
51
  id: z.string(),
34
52
  name: z.string(),
@@ -72,7 +90,8 @@ const changedScreenshotSchema = z.object({
72
90
  actualPath: z.string(),
73
91
  expectedPath: z.string(),
74
92
  diffPath: z.string(),
75
- diffMeta: diffMetadataSchema.optional()
93
+ diffMeta: diffMetadataSchema.optional(),
94
+ review: agentReviewSchema.optional()
76
95
  });
77
96
  const passedScreenshotSchema = z.object({
78
97
  ...screenshotBase,
@@ -453,6 +472,6 @@ const startWatchRequestSchema = z.object({
453
472
  maxTasks: z.number().optional()
454
473
  });
455
474
  //#endregion
456
- export { ASSET_PREFIX, ERROR_CODES, PROTOCOL_VERSION, TOKEN_HEADER, approveRequestSchema, approveResultSchema, capabilitiesSchema, changedScreenshotSchema, configResponseSchema, deletedScreenshotSchema, diffMetadataSchema, errorResponseSchema, healthResponseSchema, newScreenshotSchema, passedScreenshotSchema, pluginCaptureResultSchema, pluginInfoSchema, routes, runDetailSchema, runEventSchema, runLogLevelSchema, runStateSchema, runSummarySchema, runTriggerSchema, screenshotCategorySchema, screenshotQuerySchema, screenshotSchema, serializedErrorSchema, startRunRequestSchema, startRunResponseSchema, startWatchRequestSchema, targetSchema, targetsQuerySchema, taskFailureSchema, taskRecordSchema, taskStatusSchema, watchChangeSchema, watchEventSchema, watchScopeSchema, watchStatusSchema };
475
+ export { ASSET_PREFIX, ERROR_CODES, PROTOCOL_VERSION, TOKEN_HEADER, agentReviewSchema, approveRequestSchema, approveResultSchema, capabilitiesSchema, changedScreenshotSchema, configResponseSchema, deletedScreenshotSchema, diffMetadataSchema, errorResponseSchema, healthResponseSchema, newScreenshotSchema, passedScreenshotSchema, pluginCaptureResultSchema, pluginInfoSchema, routes, runDetailSchema, runEventSchema, runLogLevelSchema, runStateSchema, runSummarySchema, runTriggerSchema, screenshotCategorySchema, screenshotQuerySchema, screenshotSchema, serializedErrorSchema, startRunRequestSchema, startRunResponseSchema, startWatchRequestSchema, targetSchema, targetsQuerySchema, taskFailureSchema, taskRecordSchema, taskStatusSchema, watchChangeSchema, watchEventSchema, watchScopeSchema, watchStatusSchema };
457
476
 
458
477
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","names":[],"sources":["../src/screenshot.ts","../src/routes.ts","../src/run.ts"],"sourcesContent":["import { z } from \"zod\";\n\n/**\n * Screenshot shapes as they cross the wire.\n *\n * These mirror the types in `@cappa/core`, but are declared independently on\n * purpose: this package must stay installable by a browser client that has no\n * business pulling in `playwright-core` or native diff bindings. A type-level\n * compatibility assertion in `screenshot.test.ts` fails the build if the two\n * definitions drift apart.\n */\n\nexport const screenshotCategorySchema = z.enum([\n \"new\",\n \"deleted\",\n \"changed\",\n \"passed\",\n]);\n\nexport type ScreenshotCategory = z.infer<typeof screenshotCategorySchema>;\n\nexport const diffMetadataSchema = z.object({\n numDiffPixels: z.number(),\n percentDifference: z.number(),\n /**\n * Structured diff interpretation, carried opaquely.\n *\n * Its shape is owned by the diff engine (`@blazediff/core-native`'s\n * `InterpretResult`) and changes with that dependency. Pinning it here would\n * make every diff-engine upgrade a breaking protocol change for no benefit,\n * so the protocol passes it through untouched and consumers that want to\n * render the detail narrow it with `InterpretResult` from `@cappa/core`.\n */\n interpretation: z.unknown().optional(),\n});\n\nexport type DiffMetadata = z.infer<typeof diffMetadataSchema>;\n\nconst screenshotBase = {\n id: z.string(),\n name: z.string(),\n approved: z.boolean().optional(),\n /**\n * The capture task that produced this screenshot.\n *\n * Described here because it is the only way a client can re-capture one\n * screenshot: `startRun` accepts task ids, and a screenshot's `name` is not\n * one — Storybook writes `example/button/primary` for the task\n * `example-button--primary`. Optional because the engine can only know it for\n * screenshots captured since the capture manifest existed, so a client must\n * treat its absence as \"not re-capturable\" rather than substituting `name`.\n */\n taskId: z.string().optional(),\n /** Plugin that owns `taskId`. Absent whenever `taskId` is. */\n plugin: z.string().optional(),\n /**\n * Neighbours in the full, unfiltered list, so the UI can walk every\n * screenshot with the arrow keys regardless of the current filter.\n *\n * Computed by the server rather than the engine — but they must be described\n * here, or a client parsing a response would silently drop them.\n */\n next: z.string().optional(),\n prev: z.string().optional(),\n};\n\nexport const newScreenshotSchema = z.object({\n ...screenshotBase,\n category: z.literal(\"new\"),\n actualPath: z.string(),\n});\n\nexport const deletedScreenshotSchema = z.object({\n ...screenshotBase,\n category: z.literal(\"deleted\"),\n expectedPath: z.string(),\n});\n\nexport const changedScreenshotSchema = z.object({\n ...screenshotBase,\n category: z.literal(\"changed\"),\n actualPath: z.string(),\n expectedPath: z.string(),\n diffPath: z.string(),\n diffMeta: diffMetadataSchema.optional(),\n});\n\nexport const passedScreenshotSchema = z.object({\n ...screenshotBase,\n category: z.literal(\"passed\"),\n actualPath: z.string(),\n expectedPath: z.string(),\n});\n\n/**\n * The changed variant on its own.\n *\n * Exported because the review UI's comparison views only ever render a changed\n * screenshot, and typing them on the full union would force a narrow at every\n * call site.\n */\nexport type ChangedScreenshot = z.infer<typeof changedScreenshotSchema>;\n\nexport const screenshotSchema = z.discriminatedUnion(\"category\", [\n newScreenshotSchema,\n deletedScreenshotSchema,\n changedScreenshotSchema,\n passedScreenshotSchema,\n]);\n\nexport type Screenshot = z.infer<typeof screenshotSchema>;\n\nexport const screenshotQuerySchema = z.object({\n search: z.string().optional(),\n category: screenshotCategorySchema.optional(),\n});\n\nexport type ScreenshotQuery = z.infer<typeof screenshotQuerySchema>;\n\nexport const approveRequestSchema = z.object({\n names: z.array(z.string()).min(1, \"names must be a non-empty array\"),\n});\n\nexport type ApproveRequest = z.infer<typeof approveRequestSchema>;\n\nexport const approveResultSchema = z.object({\n approved: z.array(z.string()),\n errors: z.array(z.object({ name: z.string(), error: z.string() })),\n});\n\nexport type ApproveResult = z.infer<typeof approveResultSchema>;\n","import { z } from \"zod\";\nimport { screenshotCategorySchema } from \"./screenshot\";\n\n/**\n * Bumped whenever the wire contract changes incompatibly.\n *\n * Served on `GET /api/health` and checked by `@cappa/client` on its first call,\n * so a client built against an older server fails with a clear message instead\n * of mis-parsing responses.\n */\nexport const PROTOCOL_VERSION = 1;\n\n/** Capabilities a server advertises, so a client can hide what is unavailable. */\nexport const capabilitiesSchema = z.object({\n /** Capture routes are mounted (false when the server is read-only). */\n capture: z.boolean(),\n /** Screenshots can be approved. */\n approve: z.boolean(),\n /** The run event stream is available. */\n events: z.boolean(),\n /**\n * The server can watch its own filesystem and re-capture on change.\n *\n * Optional so a client built against this version still parses an older\n * server's health response, which has no such field. Absent means no.\n */\n watch: z.boolean().optional(),\n});\n\nexport type Capabilities = z.infer<typeof capabilitiesSchema>;\n\nexport const healthResponseSchema = z.object({\n ok: z.boolean(),\n protocolVersion: z.number(),\n capabilities: capabilitiesSchema,\n});\n\nexport type HealthResponse = z.infer<typeof healthResponseSchema>;\n\nexport const configResponseSchema = z.object({\n theme: z.enum([\"light\", \"dark\"]),\n readOnly: z.boolean(),\n});\n\nexport type ConfigResponse = z.infer<typeof configResponseSchema>;\n\nexport const startRunResponseSchema = z.object({\n runId: z.string(),\n});\n\nexport type StartRunResponse = z.infer<typeof startRunResponseSchema>;\n\n/**\n * Machine-readable codes on error responses.\n *\n * Kept here, in the wire contract, rather than derived from `@cappa/core`'s\n * error classes: a client must be able to tell a conflict from a validation\n * failure without installing the engine. `@cappa/core` mirrors these values and\n * a compatibility assertion there fails the build if they drift.\n */\nexport const ERROR_CODES = {\n runInProgress: \"CAPPA_RUN_IN_PROGRESS\",\n unknownTargets: \"CAPPA_UNKNOWN_TARGETS\",\n watchInProgress: \"CAPPA_WATCH_IN_PROGRESS\",\n} as const;\n\nexport type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];\n\nexport const errorResponseSchema = z.object({\n error: z.unknown(),\n code: z.string().optional(),\n activeRunId: z.string().optional(),\n taskIds: z.array(z.string()).optional(),\n});\n\nexport type ErrorResponse = z.infer<typeof errorResponseSchema>;\n\n/** Every route the server exposes, in one place. */\nexport const routes = {\n health: \"/api/health\",\n config: \"/api/config\",\n plugins: \"/api/plugins\",\n targets: \"/api/targets\",\n runs: \"/api/runs\",\n run: (id: string) => `/api/runs/${encodeURIComponent(id)}`,\n runCancel: (id: string) => `/api/runs/${encodeURIComponent(id)}/cancel`,\n runEvents: (id: string) => `/api/runs/${encodeURIComponent(id)}/events`,\n screenshots: \"/api/screenshots\",\n screenshot: (id: string) => `/api/screenshots/${encodeURIComponent(id)}`,\n approveBatch: \"/api/screenshots/approve-batch\",\n watch: \"/api/watch\",\n watchEvents: \"/api/watch/events\",\n} as const;\n\n/** Prefix under which screenshot images are served. */\nexport const ASSET_PREFIX = \"/assets/screenshots\";\n\n/** Header carrying the access token when the server is not on loopback. */\nexport const TOKEN_HEADER = \"x-cappa-token\";\n\nexport const targetsQuerySchema = z.object({\n refresh: z\n .union([\n z.literal(\"1\"),\n z.literal(\"true\"),\n z.literal(\"0\"),\n z.literal(\"false\"),\n ])\n .optional(),\n});\n\nexport { screenshotCategorySchema };\n","import { z } from \"zod\";\n\nexport const runStateSchema = z.enum([\n \"idle\",\n \"discovering\",\n \"running\",\n \"completed\",\n \"failed\",\n \"cancelled\",\n]);\n\nexport type RunState = z.infer<typeof runStateSchema>;\n\nexport const taskStatusSchema = z.enum([\n \"pending\",\n \"running\",\n \"passed\",\n \"changed\",\n \"new\",\n \"failed\",\n \"skipped\",\n]);\n\nexport type TaskStatus = z.infer<typeof taskStatusSchema>;\n\nexport const targetSchema = z.object({\n id: z.string(),\n url: z.string(),\n plugin: z.string(),\n});\n\nexport type Target = z.infer<typeof targetSchema>;\n\nexport const pluginInfoSchema = z.object({\n name: z.string(),\n description: z.string().optional(),\n});\n\nexport type PluginInfo = z.infer<typeof pluginInfoSchema>;\n\n/**\n * Why a run started, when a person did not start it.\n *\n * Carried on the request rather than as a separate lookup, so a run list can\n * say \"this one came from saving Button.stories.tsx\" from what it already has.\n */\nexport const runTriggerSchema = z.object({\n source: z.literal(\"watch\"),\n files: z.array(z.string()),\n});\n\nexport type RunTrigger = z.infer<typeof runTriggerSchema>;\n\nexport const startRunRequestSchema = z.object({\n plugins: z.array(z.string()).optional(),\n filter: z.string().optional(),\n taskIds: z.array(z.string()).optional(),\n clearActual: z.boolean().optional(),\n trigger: runTriggerSchema.optional(),\n});\n\nexport type StartRunRequest = z.infer<typeof startRunRequestSchema>;\n\nexport const serializedErrorSchema = z.object({\n name: z.string(),\n message: z.string(),\n stack: z.string().optional(),\n});\n\nexport type SerializedError = z.infer<typeof serializedErrorSchema>;\n\n/**\n * A plugin's `execute` return value.\n *\n * Only the keys the runner interprets are named; plugins are free to return\n * more, so unknown keys pass through.\n */\nexport const pluginCaptureResultSchema = z.looseObject({\n success: z.boolean().optional(),\n skipped: z.boolean().optional(),\n isNew: z.boolean().optional(),\n error: z.unknown().optional(),\n filepath: z.string().optional(),\n storyId: z.string().optional(),\n storyName: z.string().optional(),\n});\n\nexport type PluginCaptureResult = z.infer<typeof pluginCaptureResultSchema>;\n\nexport const taskFailureSchema = z.object({\n taskId: z.string(),\n taskUrl: z.string(),\n pluginName: z.string(),\n result: pluginCaptureResultSchema,\n});\n\nexport type TaskFailure = z.infer<typeof taskFailureSchema>;\n\nexport const taskRecordSchema = z.object({\n id: z.string(),\n url: z.string(),\n plugin: z.string(),\n status: taskStatusSchema,\n durationMs: z.number().optional(),\n result: pluginCaptureResultSchema.optional(),\n});\n\nexport type TaskRecord = z.infer<typeof taskRecordSchema>;\n\nexport const runSummarySchema = z.object({\n id: z.string(),\n state: runStateSchema,\n request: startRunRequestSchema,\n startedAt: z.number(),\n finishedAt: z.number().optional(),\n durationMs: z.number().optional(),\n totalTasks: z.number(),\n completedTasks: z.number(),\n failedTasks: z.number(),\n deletedScreenshots: z.array(z.string()),\n anyTasksRan: z.boolean(),\n error: serializedErrorSchema.optional(),\n});\n\nexport type RunSummary = z.infer<typeof runSummarySchema>;\n\nexport const runDetailSchema = runSummarySchema.extend({\n tasks: z.array(taskRecordSchema),\n failures: z.array(taskFailureSchema),\n});\n\nexport type RunDetail = z.infer<typeof runDetailSchema>;\n\nexport const runLogLevelSchema = z.enum([\n \"debug\",\n \"info\",\n \"warn\",\n \"error\",\n \"success\",\n]);\n\nexport type RunLogLevel = z.infer<typeof runLogLevelSchema>;\n\nconst eventBase = {\n seq: z.number(),\n runId: z.string(),\n at: z.number(),\n};\n\n/**\n * The run event stream, exactly as `@cappa/core`'s `CaptureRunner` emits it.\n *\n * `seq` is monotonic and 1-based per run; the SSE endpoint uses it as the\n * `Last-Event-ID` so a reconnecting client can replay what it missed.\n */\nexport const runEventSchema = z.discriminatedUnion(\"type\", [\n z.object({\n ...eventBase,\n type: z.literal(\"run:start\"),\n request: startRunRequestSchema,\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"discover:start\"),\n plugins: z.array(z.string()),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"discover:plugin\"),\n plugin: z.string(),\n taskCount: z.number(),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"discover:complete\"),\n targets: z.array(targetSchema),\n totalTasks: z.number(),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"filter:applied\"),\n filter: z.string().optional(),\n taskIds: z.array(z.string()).optional(),\n plugins: z.array(\n z.object({\n plugin: z.string(),\n before: z.number(),\n after: z.number(),\n }),\n ),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"plugin:start\"),\n plugin: z.string(),\n taskCount: z.number(),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"task:start\"),\n plugin: z.string(),\n taskId: z.string(),\n url: z.string(),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"task:complete\"),\n plugin: z.string(),\n taskId: z.string(),\n url: z.string(),\n status: taskStatusSchema,\n completed: z.number(),\n total: z.number(),\n durationMs: z.number(),\n result: pluginCaptureResultSchema.optional(),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"plugin:complete\"),\n plugin: z.string(),\n resultCount: z.number(),\n failed: z.boolean(),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"log\"),\n level: runLogLevelSchema,\n message: z.string(),\n args: z.array(z.unknown()),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"run:complete\"),\n summary: runSummarySchema,\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"run:error\"),\n error: serializedErrorSchema,\n }),\n z.object({ ...eventBase, type: z.literal(\"run:cancelled\") }),\n]);\n\nexport type RunEvent = z.infer<typeof runEventSchema>;\n\nexport type RunEventType = RunEvent[\"type\"];\n\n/**\n * How a watch iteration decided what to capture.\n *\n * `tasks` is the precise case; `plugins` means at least one plugin could not\n * attribute the change; `all` means the resolved set was too large or discovery\n * failed; `none` means there was nothing to capture.\n */\nexport const watchScopeSchema = z.enum([\"tasks\", \"plugins\", \"all\", \"none\"]);\n\nexport type WatchScope = z.infer<typeof watchScopeSchema>;\n\nexport const watchChangeSchema = z.object({\n files: z.array(z.string()),\n scope: watchScopeSchema,\n taskIds: z.array(z.string()).optional(),\n runId: z.string().optional(),\n error: z.string().optional(),\n at: z.number(),\n});\n\nexport type WatchChange = z.infer<typeof watchChangeSchema>;\n\nconst watchEventBase = {\n /** Monotonic, 1-based, per server. Used for SSE `Last-Event-ID` replay. */\n seq: z.number(),\n at: z.number(),\n};\n\n/**\n * The watch event stream, exactly as `@cappa/core`'s engine emits it.\n *\n * Separate from `runEventSchema` because a watch session outlives any single\n * run: the runs it starts report themselves on the ordinary run stream, and\n * these events say why they started.\n */\nexport const watchEventSchema = z.discriminatedUnion(\"type\", [\n z.object({\n ...watchEventBase,\n type: z.literal(\"watch:start\"),\n paths: z.array(z.string()),\n filter: z.string().optional(),\n debounceMs: z.number(),\n }),\n z.object({\n ...watchEventBase,\n type: z.literal(\"watch:change\"),\n files: z.array(z.string()),\n scope: watchScopeSchema,\n taskIds: z.array(z.string()).optional(),\n runId: z.string().optional(),\n error: z.string().optional(),\n }),\n z.object({\n ...watchEventBase,\n type: z.literal(\"watch:stop\"),\n reason: z.enum([\"requested\", \"engine-closed\"]),\n }),\n]);\n\nexport type WatchEvent = z.infer<typeof watchEventSchema>;\n\nexport type WatchEventType = WatchEvent[\"type\"];\n\nexport const watchStatusSchema = z.object({\n active: z.boolean(),\n paths: z.array(z.string()),\n filter: z.string().optional(),\n debounceMs: z.number(),\n startedAt: z.number().optional(),\n lastChange: watchChangeSchema.optional(),\n});\n\nexport type WatchStatus = z.infer<typeof watchStatusSchema>;\n\nexport const startWatchRequestSchema = z.object({\n paths: z.array(z.string()).optional(),\n filter: z.string().optional(),\n debounceMs: z.number().optional(),\n maxTasks: z.number().optional(),\n});\n\nexport type StartWatchRequest = z.infer<typeof startWatchRequestSchema>;\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.js","names":[],"sources":["../src/screenshot.ts","../src/routes.ts","../src/run.ts"],"sourcesContent":["import { z } from \"zod\";\n\n/**\n * Screenshot shapes as they cross the wire.\n *\n * These mirror the types in `@cappa/core`, but are declared independently on\n * purpose: this package must stay installable by a browser client that has no\n * business pulling in `playwright-core` or native diff bindings. A type-level\n * compatibility assertion in `screenshot.test.ts` fails the build if the two\n * definitions drift apart.\n */\n\nexport const screenshotCategorySchema = z.enum([\n \"new\",\n \"deleted\",\n \"changed\",\n \"passed\",\n]);\n\nexport type ScreenshotCategory = z.infer<typeof screenshotCategorySchema>;\n\nexport const diffMetadataSchema = z.object({\n numDiffPixels: z.number(),\n percentDifference: z.number(),\n /**\n * Structured diff interpretation, carried opaquely.\n *\n * Its shape is owned by the diff engine (`@blazediff/core-native`'s\n * `InterpretResult`) and changes with that dependency. Pinning it here would\n * make every diff-engine upgrade a breaking protocol change for no benefit,\n * so the protocol passes it through untouched and consumers that want to\n * render the detail narrow it with `InterpretResult` from `@cappa/core`.\n */\n interpretation: z.unknown().optional(),\n});\n\nexport type DiffMetadata = z.infer<typeof diffMetadataSchema>;\n\n/**\n * The verdict `cappa agent check` reached for a changed screenshot.\n *\n * Unlike the interpretation this is cappa's own shape, so it is described\n * rather than carried opaquely. `label` and `action` stay plain strings on the\n * wire so a newer engine adding a label does not make an older client reject\n * the whole screenshot list.\n */\nexport const agentReviewSchema = z.object({\n label: z.string(),\n headline: z.string(),\n rationale: z.array(z.string()),\n action: z.string(),\n source: z.enum([\"heuristic\", \"agent\"]),\n confidence: z.number().optional(),\n pending: z.boolean(),\n reviewedAt: z.string(),\n});\n\nexport type AgentReview = z.infer<typeof agentReviewSchema>;\n\nconst screenshotBase = {\n id: z.string(),\n name: z.string(),\n approved: z.boolean().optional(),\n /**\n * The capture task that produced this screenshot.\n *\n * Described here because it is the only way a client can re-capture one\n * screenshot: `startRun` accepts task ids, and a screenshot's `name` is not\n * one — Storybook writes `example/button/primary` for the task\n * `example-button--primary`. Optional because the engine can only know it for\n * screenshots captured since the capture manifest existed, so a client must\n * treat its absence as \"not re-capturable\" rather than substituting `name`.\n */\n taskId: z.string().optional(),\n /** Plugin that owns `taskId`. Absent whenever `taskId` is. */\n plugin: z.string().optional(),\n /**\n * Neighbours in the full, unfiltered list, so the UI can walk every\n * screenshot with the arrow keys regardless of the current filter.\n *\n * Computed by the server rather than the engine — but they must be described\n * here, or a client parsing a response would silently drop them.\n */\n next: z.string().optional(),\n prev: z.string().optional(),\n};\n\nexport const newScreenshotSchema = z.object({\n ...screenshotBase,\n category: z.literal(\"new\"),\n actualPath: z.string(),\n});\n\nexport const deletedScreenshotSchema = z.object({\n ...screenshotBase,\n category: z.literal(\"deleted\"),\n expectedPath: z.string(),\n});\n\nexport const changedScreenshotSchema = z.object({\n ...screenshotBase,\n category: z.literal(\"changed\"),\n actualPath: z.string(),\n expectedPath: z.string(),\n diffPath: z.string(),\n diffMeta: diffMetadataSchema.optional(),\n review: agentReviewSchema.optional(),\n});\n\nexport const passedScreenshotSchema = z.object({\n ...screenshotBase,\n category: z.literal(\"passed\"),\n actualPath: z.string(),\n expectedPath: z.string(),\n});\n\n/**\n * The changed variant on its own.\n *\n * Exported because the review UI's comparison views only ever render a changed\n * screenshot, and typing them on the full union would force a narrow at every\n * call site.\n */\nexport type ChangedScreenshot = z.infer<typeof changedScreenshotSchema>;\n\nexport const screenshotSchema = z.discriminatedUnion(\"category\", [\n newScreenshotSchema,\n deletedScreenshotSchema,\n changedScreenshotSchema,\n passedScreenshotSchema,\n]);\n\nexport type Screenshot = z.infer<typeof screenshotSchema>;\n\nexport const screenshotQuerySchema = z.object({\n search: z.string().optional(),\n category: screenshotCategorySchema.optional(),\n});\n\nexport type ScreenshotQuery = z.infer<typeof screenshotQuerySchema>;\n\nexport const approveRequestSchema = z.object({\n names: z.array(z.string()).min(1, \"names must be a non-empty array\"),\n});\n\nexport type ApproveRequest = z.infer<typeof approveRequestSchema>;\n\nexport const approveResultSchema = z.object({\n approved: z.array(z.string()),\n errors: z.array(z.object({ name: z.string(), error: z.string() })),\n});\n\nexport type ApproveResult = z.infer<typeof approveResultSchema>;\n","import { z } from \"zod\";\nimport { screenshotCategorySchema } from \"./screenshot\";\n\n/**\n * Bumped whenever the wire contract changes incompatibly.\n *\n * Served on `GET /api/health` and checked by `@cappa/client` on its first call,\n * so a client built against an older server fails with a clear message instead\n * of mis-parsing responses.\n */\nexport const PROTOCOL_VERSION = 1;\n\n/** Capabilities a server advertises, so a client can hide what is unavailable. */\nexport const capabilitiesSchema = z.object({\n /** Capture routes are mounted (false when the server is read-only). */\n capture: z.boolean(),\n /** Screenshots can be approved. */\n approve: z.boolean(),\n /** The run event stream is available. */\n events: z.boolean(),\n /**\n * The server can watch its own filesystem and re-capture on change.\n *\n * Optional so a client built against this version still parses an older\n * server's health response, which has no such field. Absent means no.\n */\n watch: z.boolean().optional(),\n});\n\nexport type Capabilities = z.infer<typeof capabilitiesSchema>;\n\nexport const healthResponseSchema = z.object({\n ok: z.boolean(),\n protocolVersion: z.number(),\n capabilities: capabilitiesSchema,\n});\n\nexport type HealthResponse = z.infer<typeof healthResponseSchema>;\n\nexport const configResponseSchema = z.object({\n theme: z.enum([\"light\", \"dark\"]),\n readOnly: z.boolean(),\n});\n\nexport type ConfigResponse = z.infer<typeof configResponseSchema>;\n\nexport const startRunResponseSchema = z.object({\n runId: z.string(),\n});\n\nexport type StartRunResponse = z.infer<typeof startRunResponseSchema>;\n\n/**\n * Machine-readable codes on error responses.\n *\n * Kept here, in the wire contract, rather than derived from `@cappa/core`'s\n * error classes: a client must be able to tell a conflict from a validation\n * failure without installing the engine. `@cappa/core` mirrors these values and\n * a compatibility assertion there fails the build if they drift.\n */\nexport const ERROR_CODES = {\n runInProgress: \"CAPPA_RUN_IN_PROGRESS\",\n unknownTargets: \"CAPPA_UNKNOWN_TARGETS\",\n watchInProgress: \"CAPPA_WATCH_IN_PROGRESS\",\n} as const;\n\nexport type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];\n\nexport const errorResponseSchema = z.object({\n error: z.unknown(),\n code: z.string().optional(),\n activeRunId: z.string().optional(),\n taskIds: z.array(z.string()).optional(),\n});\n\nexport type ErrorResponse = z.infer<typeof errorResponseSchema>;\n\n/** Every route the server exposes, in one place. */\nexport const routes = {\n health: \"/api/health\",\n config: \"/api/config\",\n plugins: \"/api/plugins\",\n targets: \"/api/targets\",\n runs: \"/api/runs\",\n run: (id: string) => `/api/runs/${encodeURIComponent(id)}`,\n runCancel: (id: string) => `/api/runs/${encodeURIComponent(id)}/cancel`,\n runEvents: (id: string) => `/api/runs/${encodeURIComponent(id)}/events`,\n screenshots: \"/api/screenshots\",\n screenshot: (id: string) => `/api/screenshots/${encodeURIComponent(id)}`,\n approveBatch: \"/api/screenshots/approve-batch\",\n watch: \"/api/watch\",\n watchEvents: \"/api/watch/events\",\n} as const;\n\n/** Prefix under which screenshot images are served. */\nexport const ASSET_PREFIX = \"/assets/screenshots\";\n\n/** Header carrying the access token when the server is not on loopback. */\nexport const TOKEN_HEADER = \"x-cappa-token\";\n\nexport const targetsQuerySchema = z.object({\n refresh: z\n .union([\n z.literal(\"1\"),\n z.literal(\"true\"),\n z.literal(\"0\"),\n z.literal(\"false\"),\n ])\n .optional(),\n});\n\nexport { screenshotCategorySchema };\n","import { z } from \"zod\";\n\nexport const runStateSchema = z.enum([\n \"idle\",\n \"discovering\",\n \"running\",\n \"completed\",\n \"failed\",\n \"cancelled\",\n]);\n\nexport type RunState = z.infer<typeof runStateSchema>;\n\nexport const taskStatusSchema = z.enum([\n \"pending\",\n \"running\",\n \"passed\",\n \"changed\",\n \"new\",\n \"failed\",\n \"skipped\",\n]);\n\nexport type TaskStatus = z.infer<typeof taskStatusSchema>;\n\nexport const targetSchema = z.object({\n id: z.string(),\n url: z.string(),\n plugin: z.string(),\n});\n\nexport type Target = z.infer<typeof targetSchema>;\n\nexport const pluginInfoSchema = z.object({\n name: z.string(),\n description: z.string().optional(),\n});\n\nexport type PluginInfo = z.infer<typeof pluginInfoSchema>;\n\n/**\n * Why a run started, when a person did not start it.\n *\n * Carried on the request rather than as a separate lookup, so a run list can\n * say \"this one came from saving Button.stories.tsx\" from what it already has.\n */\nexport const runTriggerSchema = z.object({\n source: z.literal(\"watch\"),\n files: z.array(z.string()),\n});\n\nexport type RunTrigger = z.infer<typeof runTriggerSchema>;\n\nexport const startRunRequestSchema = z.object({\n plugins: z.array(z.string()).optional(),\n filter: z.string().optional(),\n taskIds: z.array(z.string()).optional(),\n clearActual: z.boolean().optional(),\n trigger: runTriggerSchema.optional(),\n});\n\nexport type StartRunRequest = z.infer<typeof startRunRequestSchema>;\n\nexport const serializedErrorSchema = z.object({\n name: z.string(),\n message: z.string(),\n stack: z.string().optional(),\n});\n\nexport type SerializedError = z.infer<typeof serializedErrorSchema>;\n\n/**\n * A plugin's `execute` return value.\n *\n * Only the keys the runner interprets are named; plugins are free to return\n * more, so unknown keys pass through.\n */\nexport const pluginCaptureResultSchema = z.looseObject({\n success: z.boolean().optional(),\n skipped: z.boolean().optional(),\n isNew: z.boolean().optional(),\n error: z.unknown().optional(),\n filepath: z.string().optional(),\n storyId: z.string().optional(),\n storyName: z.string().optional(),\n});\n\nexport type PluginCaptureResult = z.infer<typeof pluginCaptureResultSchema>;\n\nexport const taskFailureSchema = z.object({\n taskId: z.string(),\n taskUrl: z.string(),\n pluginName: z.string(),\n result: pluginCaptureResultSchema,\n});\n\nexport type TaskFailure = z.infer<typeof taskFailureSchema>;\n\nexport const taskRecordSchema = z.object({\n id: z.string(),\n url: z.string(),\n plugin: z.string(),\n status: taskStatusSchema,\n durationMs: z.number().optional(),\n result: pluginCaptureResultSchema.optional(),\n});\n\nexport type TaskRecord = z.infer<typeof taskRecordSchema>;\n\nexport const runSummarySchema = z.object({\n id: z.string(),\n state: runStateSchema,\n request: startRunRequestSchema,\n startedAt: z.number(),\n finishedAt: z.number().optional(),\n durationMs: z.number().optional(),\n totalTasks: z.number(),\n completedTasks: z.number(),\n failedTasks: z.number(),\n deletedScreenshots: z.array(z.string()),\n anyTasksRan: z.boolean(),\n error: serializedErrorSchema.optional(),\n});\n\nexport type RunSummary = z.infer<typeof runSummarySchema>;\n\nexport const runDetailSchema = runSummarySchema.extend({\n tasks: z.array(taskRecordSchema),\n failures: z.array(taskFailureSchema),\n});\n\nexport type RunDetail = z.infer<typeof runDetailSchema>;\n\nexport const runLogLevelSchema = z.enum([\n \"debug\",\n \"info\",\n \"warn\",\n \"error\",\n \"success\",\n]);\n\nexport type RunLogLevel = z.infer<typeof runLogLevelSchema>;\n\nconst eventBase = {\n seq: z.number(),\n runId: z.string(),\n at: z.number(),\n};\n\n/**\n * The run event stream, exactly as `@cappa/core`'s `CaptureRunner` emits it.\n *\n * `seq` is monotonic and 1-based per run; the SSE endpoint uses it as the\n * `Last-Event-ID` so a reconnecting client can replay what it missed.\n */\nexport const runEventSchema = z.discriminatedUnion(\"type\", [\n z.object({\n ...eventBase,\n type: z.literal(\"run:start\"),\n request: startRunRequestSchema,\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"discover:start\"),\n plugins: z.array(z.string()),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"discover:plugin\"),\n plugin: z.string(),\n taskCount: z.number(),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"discover:complete\"),\n targets: z.array(targetSchema),\n totalTasks: z.number(),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"filter:applied\"),\n filter: z.string().optional(),\n taskIds: z.array(z.string()).optional(),\n plugins: z.array(\n z.object({\n plugin: z.string(),\n before: z.number(),\n after: z.number(),\n }),\n ),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"plugin:start\"),\n plugin: z.string(),\n taskCount: z.number(),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"task:start\"),\n plugin: z.string(),\n taskId: z.string(),\n url: z.string(),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"task:complete\"),\n plugin: z.string(),\n taskId: z.string(),\n url: z.string(),\n status: taskStatusSchema,\n completed: z.number(),\n total: z.number(),\n durationMs: z.number(),\n result: pluginCaptureResultSchema.optional(),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"plugin:complete\"),\n plugin: z.string(),\n resultCount: z.number(),\n failed: z.boolean(),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"log\"),\n level: runLogLevelSchema,\n message: z.string(),\n args: z.array(z.unknown()),\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"run:complete\"),\n summary: runSummarySchema,\n }),\n z.object({\n ...eventBase,\n type: z.literal(\"run:error\"),\n error: serializedErrorSchema,\n }),\n z.object({ ...eventBase, type: z.literal(\"run:cancelled\") }),\n]);\n\nexport type RunEvent = z.infer<typeof runEventSchema>;\n\nexport type RunEventType = RunEvent[\"type\"];\n\n/**\n * How a watch iteration decided what to capture.\n *\n * `tasks` is the precise case; `plugins` means at least one plugin could not\n * attribute the change; `all` means the resolved set was too large or discovery\n * failed; `none` means there was nothing to capture.\n */\nexport const watchScopeSchema = z.enum([\"tasks\", \"plugins\", \"all\", \"none\"]);\n\nexport type WatchScope = z.infer<typeof watchScopeSchema>;\n\nexport const watchChangeSchema = z.object({\n files: z.array(z.string()),\n scope: watchScopeSchema,\n taskIds: z.array(z.string()).optional(),\n runId: z.string().optional(),\n error: z.string().optional(),\n at: z.number(),\n});\n\nexport type WatchChange = z.infer<typeof watchChangeSchema>;\n\nconst watchEventBase = {\n /** Monotonic, 1-based, per server. Used for SSE `Last-Event-ID` replay. */\n seq: z.number(),\n at: z.number(),\n};\n\n/**\n * The watch event stream, exactly as `@cappa/core`'s engine emits it.\n *\n * Separate from `runEventSchema` because a watch session outlives any single\n * run: the runs it starts report themselves on the ordinary run stream, and\n * these events say why they started.\n */\nexport const watchEventSchema = z.discriminatedUnion(\"type\", [\n z.object({\n ...watchEventBase,\n type: z.literal(\"watch:start\"),\n paths: z.array(z.string()),\n filter: z.string().optional(),\n debounceMs: z.number(),\n }),\n z.object({\n ...watchEventBase,\n type: z.literal(\"watch:change\"),\n files: z.array(z.string()),\n scope: watchScopeSchema,\n taskIds: z.array(z.string()).optional(),\n runId: z.string().optional(),\n error: z.string().optional(),\n }),\n z.object({\n ...watchEventBase,\n type: z.literal(\"watch:stop\"),\n reason: z.enum([\"requested\", \"engine-closed\"]),\n }),\n]);\n\nexport type WatchEvent = z.infer<typeof watchEventSchema>;\n\nexport type WatchEventType = WatchEvent[\"type\"];\n\nexport const watchStatusSchema = z.object({\n active: z.boolean(),\n paths: z.array(z.string()),\n filter: z.string().optional(),\n debounceMs: z.number(),\n startedAt: z.number().optional(),\n lastChange: watchChangeSchema.optional(),\n});\n\nexport type WatchStatus = z.infer<typeof watchStatusSchema>;\n\nexport const startWatchRequestSchema = z.object({\n paths: z.array(z.string()).optional(),\n filter: z.string().optional(),\n debounceMs: z.number().optional(),\n maxTasks: z.number().optional(),\n});\n\nexport type StartWatchRequest = z.infer<typeof startWatchRequestSchema>;\n"],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cappa/protocol",
3
- "version": "0.9.0",
3
+ "version": "0.10.0",
4
4
  "description": "Wire contract shared by the Cappa server, clients and review UI",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -35,7 +35,7 @@
35
35
  },
36
36
  "devDependencies": {
37
37
  "@arethetypeswrong/cli": "0.18.5",
38
- "@cappa/core": "0.13.0",
38
+ "@cappa/core": "0.15.0",
39
39
  "tsdown": "0.23.0",
40
40
  "typescript": "7.0.2",
41
41
  "vitest": "5.0.0"