@sixb/agent 0.2.4 → 0.2.5

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.
Files changed (90) hide show
  1. package/README.md +2 -2
  2. package/dist/agent-prompt.d.ts.map +1 -1
  3. package/dist/artifacts/layout-check/layout-check.d.ts +21 -24
  4. package/dist/artifacts/layout-check/layout-check.d.ts.map +1 -1
  5. package/dist/artifacts/publish-tool.d.ts.map +1 -1
  6. package/dist/index.d.ts +0 -1
  7. package/dist/index.d.ts.map +1 -1
  8. package/dist/index.js +10590 -8888
  9. package/dist/index.js.map +30 -26
  10. package/dist/run-agent-turn.d.ts +3 -14
  11. package/dist/run-agent-turn.d.ts.map +1 -1
  12. package/dist/run-environment.d.ts.map +1 -1
  13. package/dist/run-subagent.d.ts.map +1 -1
  14. package/dist/sandbox-api-context.d.ts.map +1 -1
  15. package/dist/search-script.d.ts +7 -0
  16. package/dist/search-script.d.ts.map +1 -0
  17. package/dist/skills/built-in.d.ts.map +1 -1
  18. package/dist/tools/glob.d.ts +41 -0
  19. package/dist/tools/glob.d.ts.map +1 -0
  20. package/dist/tools/grep.d.ts +64 -0
  21. package/dist/tools/grep.d.ts.map +1 -0
  22. package/dist/tools/model-spec.d.ts.map +1 -1
  23. package/dist/tools/sandbox-search.d.ts +26 -0
  24. package/dist/tools/sandbox-search.d.ts.map +1 -0
  25. package/dist/tools/search/command.d.ts +15 -0
  26. package/dist/tools/search/command.d.ts.map +1 -0
  27. package/dist/tools/search/gitignore.d.ts +28 -0
  28. package/dist/tools/search/gitignore.d.ts.map +1 -0
  29. package/dist/tools/search/glob.d.ts +15 -0
  30. package/dist/tools/search/glob.d.ts.map +1 -0
  31. package/dist/tools/search/main.d.ts +2 -0
  32. package/dist/tools/search/main.d.ts.map +1 -0
  33. package/dist/tools/search/match.d.ts +30 -0
  34. package/dist/tools/search/match.d.ts.map +1 -0
  35. package/dist/tools/search/pattern.d.ts +19 -0
  36. package/dist/tools/search/pattern.d.ts.map +1 -0
  37. package/dist/tools/search/read.d.ts +62 -0
  38. package/dist/tools/search/read.d.ts.map +1 -0
  39. package/dist/tools/search/request.d.ts +80 -0
  40. package/dist/tools/search/request.d.ts.map +1 -0
  41. package/dist/tools/search/search.d.ts +4 -0
  42. package/dist/tools/search/search.d.ts.map +1 -0
  43. package/dist/tools/search/walk.d.ts +43 -0
  44. package/dist/tools/search/walk.d.ts.map +1 -0
  45. package/dist/tools/tool-outputs.d.ts.map +1 -1
  46. package/dist/turn-inbox.d.ts +75 -0
  47. package/dist/turn-inbox.d.ts.map +1 -0
  48. package/package.json +6 -4
  49. package/src/agent-prompt.ts +1 -0
  50. package/src/agent-runtime/preflight.ts +1 -0
  51. package/src/artifacts/layout-check/check.cjs +176 -95
  52. package/src/artifacts/layout-check/layout-check.ts +118 -76
  53. package/src/artifacts/publish-tool.ts +48 -99
  54. package/src/generated/search.mjs +985 -0
  55. package/src/index.ts +0 -1
  56. package/src/run-agent-turn.ts +85 -129
  57. package/src/run-conversation-turn.ts +4 -4
  58. package/src/run-environment.ts +4 -0
  59. package/src/run-subagent.ts +1 -1
  60. package/src/sandbox-api-context.ts +3 -0
  61. package/src/search-script-assets.d.ts +5 -0
  62. package/src/search-script.ts +9 -0
  63. package/src/skills/built-in.ts +16 -0
  64. package/src/skills/sixb-artifacts/SKILL.md +7 -7
  65. package/src/skills/sixb-artifacts/canvas.md +3 -2
  66. package/src/skills/sixb-artifacts/document.md +92 -5
  67. package/src/skills/sixb-artifacts/examples/document/service-proposal/design.css +114 -0
  68. package/src/skills/sixb-artifacts/examples/document/service-proposal/document.html +159 -0
  69. package/src/skills/sixb-artifacts/examples/document/service-proposal/images/fieldwise.svg +1 -0
  70. package/src/skills/sixb-artifacts/examples/document/service-proposal/images/harbor-pine.svg +1 -0
  71. package/src/skills/sixb-artifacts/queries.md +2 -1
  72. package/src/tools/glob.ts +124 -0
  73. package/src/tools/grep.ts +190 -0
  74. package/src/tools/model-spec.ts +4 -0
  75. package/src/tools/sandbox-search.ts +219 -0
  76. package/src/tools/search/command.ts +116 -0
  77. package/src/tools/search/gitignore.ts +101 -0
  78. package/src/tools/search/glob.ts +90 -0
  79. package/src/tools/search/main.ts +9 -0
  80. package/src/tools/search/match.ts +278 -0
  81. package/src/tools/search/pattern.ts +178 -0
  82. package/src/tools/search/read.ts +237 -0
  83. package/src/tools/search/request.ts +101 -0
  84. package/src/tools/search/search.ts +297 -0
  85. package/src/tools/search/walk.ts +145 -0
  86. package/src/tools/tool-outputs.ts +7 -2
  87. package/src/turn-inbox.ts +283 -0
  88. package/dist/artifacts/board-previews.d.ts +0 -41
  89. package/dist/artifacts/board-previews.d.ts.map +0 -1
  90. package/src/artifacts/board-previews.ts +0 -218
@@ -1,7 +1,6 @@
1
1
  import { posix } from "node:path"
2
2
  import type { Sandbox } from "@sixb/core"
3
- import type { ArtifactTheme, ArtifactThemeMode, Canvas } from "@sixb/core/artifacts"
4
- import { SMALL_BOARD_PREVIEW_WIDTH } from "@sixb/core/artifacts"
3
+ import type { ArtifactTheme, Canvas, DocumentPaper } from "@sixb/core/artifacts"
5
4
  import {
6
5
  FRAME_ASSETS,
7
6
  FRAME_DEFAULT_THEMES,
@@ -12,7 +11,6 @@ import {
12
11
  rewriteFrameReferences,
13
12
  } from "@sixb/core/internal/artifacts/frames"
14
13
  import { type ArtifactQueryAnswer, artifactThemeModes } from "@sixb/core/internal/artifacts/publish"
15
- import type { ArtifactBoardPreviewSize } from "@sixb/core/storage"
16
14
  import { loginShellArgs } from "../../login-shell"
17
15
  import { type AgentSandboxHandle, contextPath } from "../../sandbox-handle"
18
16
  import checkScript from "./check.cjs" with { type: "text" }
@@ -34,10 +32,10 @@ export type LayoutCheck =
34
32
  | {
35
33
  readonly status: "checked"
36
34
  readonly warnings: readonly LayoutWarning[]
37
- /** One per slide, or a page's at each width, as the agent names them. */
35
+ /** One per slide, a page's at each width, or a document's pages, as the agent names them. */
38
36
  readonly screenshots: readonly string[]
39
- /** Each `pictured` board in each mode the reader sees it in, at its path in the sandbox. */
40
- readonly previews: readonly CheckedPreview[]
37
+ /** How many pages a designed document with paper was cut into. */
38
+ readonly pages?: number
41
39
  /** A canvas as it opens in the app, as the agent names it, when the check took it. */
42
40
  readonly overview?: string
43
41
  }
@@ -61,34 +59,18 @@ export interface CheckedBoard {
61
59
  readonly w: number
62
60
  readonly h: number
63
61
  readonly html: Uint8Array
64
- /** Screenshot in every mode, not only the first: it needs its pictures for readers. */
65
- readonly pictured?: boolean
66
- }
67
-
68
- /** A board's picture in one mode and size, which the check took. */
69
- export interface CheckedPreview {
70
- readonly board: string
71
- readonly theme: ArtifactThemeMode
72
- /** `full`, a PNG of the board; `small`, a WebP at most 480 pixels wide. */
73
- readonly size: ArtifactBoardPreviewSize
74
- /** Absolute, in the sandbox. */
75
- readonly path: string
76
- /** How large the check wrote it. */
77
- readonly bytes?: number
78
62
  }
79
63
 
80
64
  interface CheckReport {
81
65
  /** The layout the check laid the entry out in, which says it ran to the end of its setup. */
82
66
  readonly layout?: CheckLayout
83
67
  readonly slides?: number
68
+ readonly pages?: number
84
69
  readonly problems?: readonly CheckedProblem[]
85
70
  readonly errors?: readonly string[]
86
71
  readonly screenshots?: readonly string[]
87
- readonly previews?: readonly CheckedPreview[]
88
72
  /** A canvas's boards whose page draws larger than the board's `w` by `h`. */
89
73
  readonly oversized?: readonly OversizedBoard[]
90
- /** A canvas's boards not pictured: something on their page did not load. */
91
- readonly unpictured?: readonly { readonly board: string; readonly reason: string }[]
92
74
  /** A canvas's boards that stopped answering, which the check went on without. */
93
75
  readonly stalls?: readonly { readonly board: string; readonly message: string }[]
94
76
  readonly overview?: string
@@ -109,10 +91,11 @@ export type CheckedQuery = ArtifactQueryAnswer
109
91
  export type PageView = "desktop" | "phone"
110
92
 
111
93
  /**
112
- * Lays a published deck, page, or canvas out in the sandbox's headless Chromium, as the app's
113
- * frame does, and reports what a reader would find wrong: on each slide of a deck, on a page at a
114
- * laptop's width and a phone's, or on each of a canvas's boards at its own size, with a screenshot
115
- * of each for the Agent to look at. A sandbox without the agent image's browser skips it; so does
94
+ * Lays a published deck, page, designed document, or canvas out in the sandbox's headless
95
+ * Chromium, as the app's frame does, and reports what a reader would find wrong: on each slide of
96
+ * a deck, on a page at a laptop's width and a phone's, on a designed document as one sheet and on
97
+ * each of its pages, or on each of a canvas's boards at its own size, with a screenshot of each for
98
+ * the Agent to look at. A sandbox without the agent image's browser skips it; so does
116
99
  * a check that fails, which never costs the Agent its publish.
117
100
  */
118
101
  export async function checkLayout(
@@ -132,7 +115,12 @@ export async function checkLayout(
132
115
  /** Test seam; production allows 120 seconds. */
133
116
  readonly timeoutMs?: number
134
117
  } & (
135
- | { readonly layout: FrameLayout; readonly entry: Uint8Array }
118
+ | {
119
+ readonly layout: FrameLayout
120
+ readonly entry: Uint8Array
121
+ /** A designed document's paper, which its runtime cuts it into pages by. */
122
+ readonly paper?: DocumentPaper
123
+ }
136
124
  | {
137
125
  readonly layout: "canvas"
138
126
  readonly boards: readonly CheckedBoard[]
@@ -155,13 +143,21 @@ export async function checkLayout(
155
143
  layout: "page" as const,
156
144
  html: board.html,
157
145
  }))
158
- : [{ path: "index.html", layout: input.layout, html: input.entry }]
146
+ : [
147
+ {
148
+ path: input.layout === "document" ? "document.html" : "index.html",
149
+ layout: input.layout,
150
+ html: input.entry,
151
+ },
152
+ ]
153
+ const paper = input.layout !== "canvas" ? input.paper : undefined
159
154
  const entries = pages.map((page) => ({
160
155
  path: page.path,
161
156
  contents: injectFrameAssets(
162
157
  rewriteFrameReferences(new TextDecoder().decode(page.html), [], page.path),
163
158
  page.layout,
164
- page.path
159
+ page.path,
160
+ paper
165
161
  ),
166
162
  }))
167
163
  await sandbox.writeFiles([
@@ -171,6 +167,7 @@ export async function checkLayout(
171
167
  { path: posix.join(library, "check.cjs"), contents: checkScript },
172
168
  { path: posix.join(library, "deck.css"), contents: asset("__sixb/deck.css") },
173
169
  { path: posix.join(library, "page.css"), contents: asset("__sixb/page.css") },
170
+ { path: posix.join(library, "document.css"), contents: asset("__sixb/document.css") },
174
171
  { path: posix.join(library, "runtime.js"), contents: asset("__sixb/runtime.js") },
175
172
  { path: posix.join(library, "probe.js"), contents: `(${layoutProbe.toString()})` },
176
173
  ]),
@@ -189,14 +186,7 @@ export async function checkLayout(
189
186
  {
190
187
  path: posix.join(output, "boards.json"),
191
188
  contents: JSON.stringify(
192
- input.boards.map(({ id, file, w, h, pictured }) => ({
193
- id,
194
- file,
195
- w,
196
- h,
197
- pictured: pictured === true,
198
- ...(pictured ? { smallWidth: SMALL_BOARD_PREVIEW_WIDTH } : {}),
199
- }))
189
+ input.boards.map(({ id, file, w, h }) => ({ id, file, w, h }))
200
190
  ),
201
191
  },
202
192
  ...overviewFiles(output, input.canvas, input.theme),
@@ -249,30 +239,24 @@ export async function checkLayout(
249
239
  console.warn(`[SixbAgent] The layout check failed: ${detail.slice(0, 500)}`)
250
240
  return { status: "skipped", reason: "the check failed in the sandbox" }
251
241
  }
252
- const noun = { deck: "deck", page: "page", canvas: "canvas" }[input.layout]
253
- const reached = { deck: "Slides", page: "Widths", canvas: "Boards" }[input.layout]
242
+ const noun = { deck: "deck", page: "page", document: "document", canvas: "canvas" }[input.layout]
243
+ const reached = { deck: "Slides", page: "Widths", document: "Pages", canvas: "Boards" }[
244
+ input.layout
245
+ ]
254
246
  const checks = posix.join(input.handle.contextDirectory, CHECKS, input.name)
255
247
  const named = (path: string) => posix.join(checks, posix.relative(output, path))
256
248
  const screenshots = (report.screenshots ?? []).map(named)
257
249
  return {
258
250
  status: "checked",
259
251
  screenshots,
260
- // Only pictures of the boards asked for, where the check writes them.
261
- previews: (report.previews ?? []).filter(
262
- ({ board, path }) =>
263
- input.layout === "canvas" &&
264
- input.boards.some((each) => each.id === board && each.pictured) &&
265
- path.startsWith(`${output}/`)
266
- ),
252
+ ...(report.pages ? { pages: report.pages } : {}),
267
253
  ...(report.overview ? { overview: named(report.overview) } : {}),
268
254
  warnings: [
269
- ...layoutWarnings(report.problems ?? []),
255
+ ...layoutWarnings(
256
+ report.problems ?? [],
257
+ input.layout === "document" ? "document" : undefined
258
+ ),
270
259
  ...oversizedWarnings(report.oversized ?? []),
271
- ...(report.unpictured ?? []).map(({ board, reason }) => ({
272
- code: "preview_not_taken",
273
- part: board,
274
- message: `Board '${board}' has no preview: ${reason.slice(0, 200)}, and a picture of it would show it broken to every reader. It shows its outline until a version loads whole.`,
275
- })),
276
260
  ...(report.stalls ?? []).map(({ board, message }) => ({
277
261
  code: "layout_incomplete",
278
262
  part: board,
@@ -412,10 +396,16 @@ const SEVERITY: readonly LayoutProblem["code"][] = [
412
396
  ]
413
397
  const VIEWS: readonly PageView[] = ["desktop", "phone"]
414
398
 
415
- /** A problem where the check found it: on a deck's slide, or on a page at one width. */
399
+ /**
400
+ * A problem where the check found it: on a deck's slide, on a page at one width, on a designed
401
+ * document's page, or on a designed document as one sheet, at its paper's width, which names none
402
+ * of them, or on a phone.
403
+ */
416
404
  type CheckedProblem = LayoutProblem & {
417
405
  readonly theme: "light" | "dark"
418
406
  readonly slide?: number
407
+ /** A designed document's page. */
408
+ readonly page?: number
419
409
  readonly view?: PageView
420
410
  /** The canvas's board it is on. */
421
411
  readonly board?: string
@@ -427,20 +417,28 @@ type CheckedProblem = LayoutProblem & {
427
417
  * same colors, is one warning naming every slide or width it is at, so a deck's eyebrow at 17px
428
418
  * is one line, not nine. Contrast says which theme it fails in when it fails in one.
429
419
  */
430
- export function layoutWarnings(problems: readonly CheckedProblem[]): LayoutWarning[] {
420
+ export function layoutWarnings(
421
+ problems: readonly CheckedProblem[],
422
+ /** What was checked when it is a designed document, whose problems at a width are its own. */
423
+ checked?: "document"
424
+ ): LayoutWarning[] {
431
425
  const groups = new Map<
432
426
  string,
433
427
  {
434
428
  problem: CheckedProblem
435
429
  slides: Set<number>
430
+ pages: Set<number>
436
431
  views: Set<PageView>
437
432
  boards: Set<string>
433
+ /** Whether it is on a designed document's sheet, at its paper's width: everywhere it shows. */
434
+ sheet: boolean
438
435
  texts: Set<string>
439
436
  themes: Set<string>
440
437
  }
441
438
  >()
442
439
  for (const problem of problems) {
443
- const at = problem.slide ?? problem.view ?? problem.board
440
+ const at =
441
+ problem.slide ?? (problem.page && `page ${problem.page}`) ?? problem.view ?? problem.board
444
442
  const cause =
445
443
  problem.code === "small_text" || problem.code === "small_target"
446
444
  ? `${problem.selector}|${problem.size}`
@@ -451,14 +449,18 @@ export function layoutWarnings(problems: readonly CheckedProblem[]): LayoutWarni
451
449
  const group = groups.get(key) ?? {
452
450
  problem,
453
451
  slides: new Set(),
452
+ pages: new Set(),
454
453
  views: new Set(),
455
454
  boards: new Set(),
455
+ sheet: false,
456
456
  texts: new Set(),
457
457
  themes: new Set(),
458
458
  }
459
459
  if (problem.slide !== undefined) group.slides.add(problem.slide)
460
+ if (problem.page !== undefined) group.pages.add(problem.page)
460
461
  if (problem.view) group.views.add(problem.view)
461
462
  if (problem.board) group.boards.add(problem.board)
463
+ if (at === undefined) group.sheet = true
462
464
  group.texts.add(problem.text)
463
465
  group.themes.add(problem.theme)
464
466
  groups.set(key, group)
@@ -467,37 +469,61 @@ export function layoutWarnings(problems: readonly CheckedProblem[]): LayoutWarni
467
469
  const boardOrder = [
468
470
  ...new Set(problems.flatMap((problem) => (problem.board ? [problem.board] : []))),
469
471
  ]
470
- const first = (group: { slides: Set<number>; views: Set<PageView>; boards: Set<string> }) =>
472
+ const first = (group: {
473
+ slides: Set<number>
474
+ pages: Set<number>
475
+ views: Set<PageView>
476
+ boards: Set<string>
477
+ }) =>
471
478
  group.slides.size > 0
472
479
  ? Math.min(...group.slides)
473
- : group.boards.size > 0
474
- ? Math.min(...[...group.boards].map((board) => boardOrder.indexOf(board)))
475
- : Math.min(...[...group.views].map((view) => VIEWS.indexOf(view)))
480
+ : group.pages.size > 0
481
+ ? Math.min(...group.pages)
482
+ : group.boards.size > 0
483
+ ? Math.min(...[...group.boards].map((board) => boardOrder.indexOf(board)))
484
+ : group.views.size > 0
485
+ ? Math.min(...[...group.views].map((view) => VIEWS.indexOf(view)))
486
+ : 0
476
487
  const ordered = [...groups.values()].sort(
477
488
  (a, b) =>
478
489
  SEVERITY.indexOf(a.problem.code) - SEVERITY.indexOf(b.problem.code) || first(a) - first(b)
479
490
  )
480
491
  const warnings: LayoutWarning[] = ordered
481
492
  .slice(0, MAX_WARNINGS)
482
- .map(({ problem, slides, views, boards, texts, themes }) => {
493
+ .map(({ problem, slides, pages, views, boards, sheet, texts, themes }) => {
483
494
  const theme =
484
495
  problem.code === "contrast" && themes.size === 1 ? ` in ${[...themes][0]} mode` : ""
485
- const page = slides.size === 0
486
496
  const onBoards = boardOrder.filter((board) => boards.has(board))
497
+ // A designed document's problem names its pages, a phone, or, found on its sheet, nothing.
498
+ const place: Place =
499
+ slides.size > 0
500
+ ? "slide"
501
+ : checked !== "document" && (boards.size > 0 || views.size > 0)
502
+ ? "page"
503
+ : "document"
487
504
  const where =
488
505
  onBoards.length > 0
489
506
  ? boardList(onBoards)
490
- : page
491
- ? viewList([...views])
492
- : slideList([...slides])
507
+ : slides.size > 0
508
+ ? slideList([...slides])
509
+ : pages.size > 0
510
+ ? numberedList("Page", [...pages])
511
+ : views.size > 0 && !sheet
512
+ ? viewList([...views])
513
+ : "In the document"
514
+ const part =
515
+ onBoards[0] ??
516
+ (slides.size > 0
517
+ ? String(Math.min(...slides))
518
+ : pages.size > 0
519
+ ? `page ${Math.min(...pages)}`
520
+ : views.size > 0 && !sheet
521
+ ? (VIEWS.find((view) => views.has(view)) ?? "desktop")
522
+ : undefined)
493
523
  return {
494
524
  code: `layout_${problem.code}`,
495
- part:
496
- onBoards[0] ??
497
- (page
498
- ? (VIEWS.find((view) => views.has(view)) ?? "desktop")
499
- : String(Math.min(...slides))),
500
- message: `${where}: ${describeProblem(problem, [...texts], page)}${theme}.`,
525
+ ...(part ? { part } : {}),
526
+ message: `${where}: ${describeProblem(problem, [...texts], place)}${theme}.`,
501
527
  }
502
528
  })
503
529
  const more = ordered.length - warnings.length
@@ -519,7 +545,12 @@ function boardList(boards: readonly string[]): string {
519
545
 
520
546
  /** `Slide 3`, `Slides 1–4 and 7`. */
521
547
  function slideList(slides: number[]): string {
522
- const sorted = [...slides].sort((a, b) => a - b)
548
+ return numberedList("Slide", slides)
549
+ }
550
+
551
+ /** `Page 3`, `Pages 1–4 and 7`: what `noun` names, by number. */
552
+ function numberedList(noun: string, numbers: number[]): string {
553
+ const sorted = [...numbers].sort((a, b) => a - b)
523
554
  const runs: string[] = []
524
555
  for (let index = 0; index < sorted.length; ) {
525
556
  let end = index
@@ -528,7 +559,7 @@ function slideList(slides: number[]): string {
528
559
  index = end + 1
529
560
  }
530
561
  const label = runs.length > 1 ? `${runs.slice(0, -1).join(", ")} and ${runs.at(-1)}` : runs[0]
531
- return `${sorted.length === 1 ? "Slide" : "Slides"} ${label}`
562
+ return `${sorted.length === 1 ? noun : `${noun}s`} ${label}`
532
563
  }
533
564
 
534
565
  /** `On a phone (390px)`, `At 1280px and on a phone`. */
@@ -537,7 +568,10 @@ function viewList(views: PageView[]): string {
537
568
  return views[0] === "phone" ? "On a phone (390px)" : "At 1280px"
538
569
  }
539
570
 
540
- function describeProblem(problem: LayoutProblem, texts: readonly string[], page: boolean): string {
571
+ /** Where a problem is: on a slide, on a web page, or in a designed document. */
572
+ type Place = "slide" | "page" | "document"
573
+
574
+ function describeProblem(problem: CheckedProblem, texts: readonly string[], place: Place): string {
541
575
  const { x, y, width, height } = problem.rect
542
576
  const where = `at ${x},${y} (${width}×${height})`
543
577
  const quoted = texts
@@ -547,17 +581,25 @@ function describeProblem(problem: LayoutProblem, texts: readonly string[], page:
547
581
  const what = `${problem.selector} ${quoted}${texts.length > 2 ? ` and ${texts.length - 2} more` : ""}`
548
582
  switch (problem.code) {
549
583
  case "outside":
550
- return `${what} runs past the slide's edge ${where}, which cuts it off`
584
+ return place === "document"
585
+ ? `${what} runs past the page's edge ${where}, which cuts it off; let it wrap or shrink, or give it a page of its own`
586
+ : `${what} runs past the slide's edge ${where}, which cuts it off`
551
587
  case "footer":
552
588
  return `${what} runs into the footer ${where}; keep content above the source line`
553
589
  case "wide":
590
+ if (place === "document" && problem.view === "phone") {
591
+ return `${what} runs past the screen's right edge ${where}, so the document scrolls sideways; let it wrap, or stack it in an @media screen and (max-width: 600px) rule`
592
+ }
593
+ if (place === "document") {
594
+ return `${what} runs past the sheet's right edge ${where}, past where it can print; let it wrap or shrink`
595
+ }
554
596
  return `${what} runs past the screen's right edge ${where}, so the whole page scrolls sideways; let it wrap or shrink, or put it in a box that scrolls (.table-scroll)`
555
597
  case "overlap":
556
598
  return `${what} is drawn over “${problem.other}” ${where}`
557
599
  case "clipped":
558
600
  return `${what} is cut off by its own box ${where}`
559
601
  case "small_text":
560
- return page
602
+ return place !== "slide"
561
603
  ? `${what} ${texts.length === 1 ? "is" : "are"} ${problem.size}px; nothing on a page may be under 12px`
562
604
  : `${what} ${texts.length === 1 ? "is" : "are"} ${problem.size}px; nothing on a slide may be under 18px`
563
605
  case "small_target":
@@ -20,15 +20,14 @@ import {
20
20
  AgentExecutionLostError,
21
21
  type AgentRunArtifacts,
22
22
  type AgentRunFileStore,
23
- type AgentRunMissingPreview,
24
23
  } from "@sixb/core/internal/agents"
25
24
  import { frameLayout } from "@sixb/core/internal/artifacts/frames"
26
25
  import {
27
26
  ARTIFACT_LIMITS,
28
27
  answerArtifactQueries,
28
+ DOCUMENT_HOLDER_QUERY,
29
29
  isArtifactId,
30
30
  type PublishedArtifact,
31
- type RefusedBoardPreview,
32
31
  } from "@sixb/core/internal/artifacts/publish"
33
32
  import { inferFileMediaType } from "@sixb/core/internal/blob-storage"
34
33
  import type { JsonObject, ModelTool } from "@sixb/core/models"
@@ -42,9 +41,7 @@ import {
42
41
  } from "../sandbox-files"
43
42
  import type { AgentSandboxHandle } from "../sandbox-handle"
44
43
  import type { AgentFileBudget } from "../tools/tool-files"
45
- import { storeCheckedPreviews } from "./board-previews"
46
44
  import {
47
- type CheckedPreview,
48
45
  type CheckedQuery,
49
46
  checkLayout,
50
47
  type LayoutCheck,
@@ -221,7 +218,7 @@ async function publish(
221
218
  const sources = await listSources(handle, request.path, kind, tool, signal)
222
219
 
223
220
  // An installed artifact is updated from its copy: writing past the revision the copy holds would
224
- // drop whatever was written since. A canvas is merged instead, from the copy's files.
221
+ // drop whatever was written since. A canvas or a document is merged instead, from the copy's files.
225
222
  const base =
226
223
  "artifactId" in request.target ? installed.baseOf(request.target.artifactId) : undefined
227
224
  const baseRevision =
@@ -279,8 +276,6 @@ async function publish(
279
276
  : { kind }),
280
277
  title: request.title,
281
278
  files,
282
- // The layout check pictures a canvas's boards as it checks them.
283
- rendersPreviews: kind === "canvas",
284
279
  })
285
280
  } catch (error) {
286
281
  // Nothing was published, so the bytes do not count against the run.
@@ -339,9 +334,9 @@ async function publish(
339
334
  )
340
335
  }
341
336
  }
342
- // A published deck, page, or canvas is laid out in the sandbox's browser, so the Agent sees what
343
- // the reader will, and fixes it in its next update.
344
- const layout = frameLayout(kind)
337
+ // A published deck, page, designed document, or canvas is laid out in the sandbox's browser, so
338
+ // the Agent sees what the reader will, and fixes it in its next update.
339
+ const layout = frameLayout(version)
345
340
  const { outline, entry } = version
346
341
  const root = layout ? sources.find((source) => source.path === entry) : undefined
347
342
  // A merged version is checked from its installed copy, which holds what it holds.
@@ -353,10 +348,6 @@ async function publish(
353
348
  const themeFile = checked?.find((file) => file.path === ARTIFACT_THEME_FILE)
354
349
  // Publishing has read it already: a version with a theme.json it refused is not here.
355
350
  const theme = themeFile ? parseArtifactTheme(new TextDecoder().decode(themeFile.bytes)) : null
356
- // A reader sees a canvas's boards as pictures until they open one: the check takes those its
357
- // boards miss, in every mode. A board kept as it was keeps the pictures it had.
358
- const missing = outline.kind === "canvas" ? await missingPreviews(input.artifacts, published) : []
359
- const pictured = new Set(missing.map(({ board }) => board))
360
351
  // What the check opens: a canvas's boards, each at its own size, or the entry.
361
352
  const pages =
362
353
  outline.kind === "canvas"
@@ -372,7 +363,6 @@ async function publish(
372
363
  w: item.w,
373
364
  h: item.h,
374
365
  html,
375
- pictured: pictured.has(item.id),
376
366
  },
377
367
  ]
378
368
  : []
@@ -380,7 +370,11 @@ async function publish(
380
370
  ...canvasOf(bytesOf(CANVAS_FILE)),
381
371
  }
382
372
  : layout && bytesOf(entry)
383
- ? { layout, entry: bytesOf(entry) as Uint8Array }
373
+ ? {
374
+ layout,
375
+ entry: bytesOf(entry) as Uint8Array,
376
+ ...(outline.kind === "document" && outline.paper ? { paper: outline.paper } : {}),
377
+ }
384
378
  : null
385
379
  let check: LayoutCheck | undefined
386
380
  let queries: CheckedQueries = { answers: {}, warnings: [] }
@@ -410,10 +404,6 @@ async function publish(
410
404
  check = { status: "skipped", reason: "the check failed in the sandbox" }
411
405
  }
412
406
  }
413
- const previewWarnings =
414
- check?.status === "checked" && missing.length > 0
415
- ? await storePreviews({ input, handle, published, missing, checked: check.previews, signal })
416
- : []
417
407
  return {
418
408
  artifactId: artifact.id,
419
409
  // A new artifact, or a revision of one: what its summary and its row say.
@@ -432,7 +422,6 @@ async function publish(
432
422
  ...published.warnings,
433
423
  ...queries.warnings,
434
424
  ...(check?.status === "checked" ? check.warnings : []),
435
- ...previewWarnings,
436
425
  ].map(({ code, message, part }) => ({
437
426
  code,
438
427
  message,
@@ -445,6 +434,7 @@ async function publish(
445
434
  check.status === "checked"
446
435
  ? {
447
436
  screenshots: [...check.screenshots],
437
+ ...(check.pages ? { pages: check.pages } : {}),
448
438
  ...(check.overview ? { overview: check.overview } : {}),
449
439
  }
450
440
  : { skipped: check.reason },
@@ -473,80 +463,6 @@ async function mergedFiles(
473
463
  }
474
464
  }
475
465
 
476
- /**
477
- * The boards of the revision just written that miss a picture. A preview never costs a publish:
478
- * when they cannot be read, the check pictures none and the worker renders what is missing.
479
- */
480
- async function missingPreviews(
481
- artifacts: Pick<AgentRunArtifacts, "missingPreviews">,
482
- published: PublishedArtifact
483
- ): Promise<readonly AgentRunMissingPreview[]> {
484
- try {
485
- return await artifacts.missingPreviews(writtenAt(published))
486
- } catch (error) {
487
- console.warn(
488
- `[SixbAgent] Could not read which boards of '${published.artifact.id}' miss a preview:`,
489
- error
490
- )
491
- return []
492
- }
493
- }
494
-
495
- /**
496
- * Hands the pictures the check took over as the revision's previews, and warns of each board one
497
- * of whose pictures was not kept: it shows its outline in that size and mode. The write exists by
498
- * now, so a failure is only logged: the worker renders what is still missing, and an update
499
- * written since gets its own.
500
- */
501
- async function storePreviews(context: {
502
- readonly input: PublishToolsInput
503
- readonly handle: AgentSandboxHandle
504
- readonly published: PublishedArtifact
505
- readonly missing: readonly AgentRunMissingPreview[]
506
- readonly checked: readonly CheckedPreview[]
507
- readonly signal: AbortSignal
508
- }): Promise<LayoutWarning[]> {
509
- const { input, published, signal } = context
510
- try {
511
- const { previews, dropped } = await storeCheckedPreviews({
512
- handle: context.handle,
513
- checked: context.checked,
514
- missing: context.missing,
515
- blobStorage: input.blobStorage,
516
- signal,
517
- })
518
- const refused = await input.artifacts.storePreviews({ ...writtenAt(published), previews })
519
- return unkeptPreviewWarnings([...dropped, ...refused])
520
- } catch (error) {
521
- if (signal.aborted) throw error
522
- console.warn(
523
- `[SixbAgent] Could not keep the previews of revision ${published.version.revision} of '${published.artifact.id}':`,
524
- error
525
- )
526
- return []
527
- }
528
- }
529
-
530
- /** The version a publish wrote, as it left its content. */
531
- function writtenAt({ artifact, version }: PublishedArtifact) {
532
- return { artifactId: artifact.id, version: version.version, updatedAt: version.updatedAt }
533
- }
534
-
535
- /** One warning per board whose pictures were not all kept, naming each and why. */
536
- function unkeptPreviewWarnings(unkept: readonly RefusedBoardPreview[]): LayoutWarning[] {
537
- const boards = [...new Set(unkept.map(({ board }) => board))]
538
- return boards.map((board) => {
539
- const pictures = unkept
540
- .filter((picture) => picture.board === board)
541
- .map(({ theme, size, reason }) => `the ${size} one in ${theme} mode (${reason})`)
542
- return {
543
- code: "preview_not_kept",
544
- part: board,
545
- message: `Board '${board}' has no preview for ${pictures.join(", ")}: readers see its outline there until they open it.`,
546
- }
547
- })
548
- }
549
-
550
466
  /** A canvas's items, for the check's picture of it as it opens; none when it cannot be read. */
551
467
  function canvasOf(bytes: Uint8Array | undefined): { readonly canvas?: Canvas } {
552
468
  const parsed = bytes ? parseCanvas(new TextDecoder().decode(bytes)) : undefined
@@ -577,8 +493,9 @@ async function checkedQueries(
577
493
 
578
494
  return {
579
495
  answers: Object.fromEntries(answers),
496
+ // A document no object holds yet shows its written text: none of its queries failed.
580
497
  warnings: answers.flatMap(([name, answer]) =>
581
- "error" in answer
498
+ "error" in answer && name !== DOCUMENT_HOLDER_QUERY
582
499
  ? [
583
500
  {
584
501
  code: "query_failed",
@@ -800,7 +717,13 @@ async function listSources(
800
717
  })
801
718
  return [
802
719
  {
803
- path: kind === "document" ? "document.md" : posix.basename(absolutePath),
720
+ // A document's one file is its entry: HTML when it is designed, Markdown otherwise.
721
+ path:
722
+ kind === "document"
723
+ ? /\.html?$/i.test(absolutePath)
724
+ ? "document.html"
725
+ : "document.md"
726
+ : posix.basename(absolutePath),
804
727
  absolutePath,
805
728
  sizeBytes: bytes.byteLength,
806
729
  bytes,
@@ -903,7 +826,9 @@ function publishSummary(output: JsonValue): string {
903
826
  ? "Read index.html and its scripts closely."
904
827
  : kind === "canvas"
905
828
  ? "Read each board's HTML closely."
906
- : "Read index.html slide by slide."
829
+ : kind === "document"
830
+ ? "Read document.html and its stylesheets closely: what fits the paper, and where each page breaks."
831
+ : "Read index.html slide by slide."
907
832
  }`
908
833
  )
909
834
  } else if (screenshots.length > 0) {
@@ -917,7 +842,13 @@ function publishSummary(output: JsonValue): string {
917
842
  ? ` Open ${check.overview} to see the canvas as it opens, fitted to a 1440×900 window, and check that it reads at that zoom.`
918
843
  : ""
919
844
  }`
920
- : `Layout check: each slide as the reader sees it, in light mode or the mode its theme.json pins, is ${directory}/slide-NN.png (${screenshots.length} slides). Open them with read, fix what the warnings name, and update the artifact.`
845
+ : kind === "document"
846
+ ? documentShots(
847
+ directory,
848
+ screenshots,
849
+ typeof check.pages === "number" ? check.pages : undefined
850
+ )
851
+ : `Layout check: each slide as the reader sees it, in light mode or the mode its theme.json pins, is ${directory}/slide-NN.png (${screenshots.length} slides). Open them with read, fix what the warnings name, and update the artifact.`
921
852
  )
922
853
  }
923
854
  }
@@ -1010,3 +941,21 @@ function publishError(tool: ArtifactToolName, message: string): AgentToolPublicE
1010
941
  const sentence = /[.!?]$/.test(message) ? message : `${message}.`
1011
942
  return new AgentToolPublicError(`[SixbAgent] ${tool} refused: ${sentence}`)
1012
943
  }
944
+
945
+ /**
946
+ * Where a designed document's screenshots are: its pages as they print, or its one sheet when it
947
+ * has no paper, and the top of it on a phone.
948
+ */
949
+ function documentShots(
950
+ directory: string,
951
+ screenshots: readonly string[],
952
+ pages: number | undefined
953
+ ): string {
954
+ const shot = screenshots.filter((each) => posix.basename(each).startsWith("page-")).length
955
+ const phone = ` ${directory}/phone.png is its top 4000px on a phone (390px), where it shows as one sheet: check that nothing runs off the side.`
956
+ if (shot === 0) {
957
+ return `Layout check: the document as one sheet is ${directory}/document.png. It has no paper, so no pages: give its stylesheet an @page rule with a size to print it.${phone} Open them with read, fix what the warnings name, and update the artifact.`
958
+ }
959
+ const count = pages ?? shot
960
+ return `Layout check: each page as it prints is ${directory}/page-NN.png (${count} pages${count > shot ? `, the first ${shot} shot` : ""}).${phone} Open them with read, check where each page breaks and that nothing is cut off, fix what the warnings name, and update the artifact.`
961
+ }