@cliangdev/conductor 0.51.0 → 0.53.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.
Files changed (139) hide show
  1. package/assets/claude/agents/conductor-marketing-art-director.md +2 -1
  2. package/assets/claude/skills/conductor-marketing-create/SKILL.md +12 -2
  3. package/assets/claude/skills/conductor-marketing-create/references/capabilities.md +9 -2
  4. package/assets/claude/skills/conductor-marketing-create/references/direct.md +39 -6
  5. package/assets/claude/skills/conductor-marketing-create/references/platform-specs.md +15 -4
  6. package/assets/claude/skills/conductor-marketing-create/references/shotlist-template.md +2 -2
  7. package/assets/claude/skills/conductor-marketing-create/references/slideshow-formats.md +2 -1
  8. package/assets/claude/skills/conductor-marketing-create/references/team-run.md +3 -3
  9. package/assets/claude/skills/conductor-marketing-report/SKILL.md +2 -2
  10. package/assets/cli-manifest.json +261 -23
  11. package/dist/creative/assertions.js +30 -3
  12. package/dist/creative/frame.js +2 -2
  13. package/dist/creative/job/media.mjs +2 -2
  14. package/dist/creative/job/render.mjs +3 -0
  15. package/dist/creative/placements.js +2 -2
  16. package/dist/creative/placements.json +3 -3
  17. package/dist/creative/render.js +20 -8
  18. package/dist/lib/creative-render.d.ts +14 -1
  19. package/dist/lib/creative-render.d.ts.map +1 -1
  20. package/dist/lib/creative-render.js +3 -1
  21. package/dist/lib/creative-render.js.map +1 -1
  22. package/dist/lib/safe-zone/check.d.ts +31 -0
  23. package/dist/lib/safe-zone/check.d.ts.map +1 -0
  24. package/dist/lib/safe-zone/check.js +267 -0
  25. package/dist/lib/safe-zone/check.js.map +1 -0
  26. package/dist/lib/safe-zone/frames.d.ts +35 -0
  27. package/dist/lib/safe-zone/frames.d.ts.map +1 -0
  28. package/dist/lib/safe-zone/frames.js +132 -0
  29. package/dist/lib/safe-zone/frames.js.map +1 -0
  30. package/dist/lib/safe-zone/ocr.d.ts +42 -0
  31. package/dist/lib/safe-zone/ocr.d.ts.map +1 -0
  32. package/dist/lib/safe-zone/ocr.js +139 -0
  33. package/dist/lib/safe-zone/ocr.js.map +1 -0
  34. package/dist/lib/safe-zone/overlay.d.ts +59 -0
  35. package/dist/lib/safe-zone/overlay.d.ts.map +1 -0
  36. package/dist/lib/safe-zone/overlay.js +283 -0
  37. package/dist/lib/safe-zone/overlay.js.map +1 -0
  38. package/dist/lib/safe-zone/zones.d.ts +46 -0
  39. package/dist/lib/safe-zone/zones.d.ts.map +1 -0
  40. package/dist/lib/safe-zone/zones.js +84 -0
  41. package/dist/lib/safe-zone/zones.js.map +1 -0
  42. package/dist/lib/slideshow/compose.d.ts +2 -0
  43. package/dist/lib/slideshow/compose.d.ts.map +1 -1
  44. package/dist/lib/slideshow/compose.js +1 -1
  45. package/dist/lib/slideshow/compose.js.map +1 -1
  46. package/dist/lib/slideshow/css.d.ts +2 -0
  47. package/dist/lib/slideshow/css.d.ts.map +1 -1
  48. package/dist/lib/slideshow/css.js +9 -5
  49. package/dist/lib/slideshow/css.js.map +1 -1
  50. package/dist/lib/slideshow/html.d.ts +12 -3
  51. package/dist/lib/slideshow/html.d.ts.map +1 -1
  52. package/dist/lib/slideshow/html.js +16 -10
  53. package/dist/lib/slideshow/html.js.map +1 -1
  54. package/dist/lib/slideshow/spec-transport.d.ts.map +1 -1
  55. package/dist/lib/slideshow/spec-transport.js +4 -2
  56. package/dist/lib/slideshow/spec-transport.js.map +1 -1
  57. package/dist/lib/slideshow/spec.d.ts +8 -0
  58. package/dist/lib/slideshow/spec.d.ts.map +1 -1
  59. package/dist/lib/slideshow/spec.js +6 -0
  60. package/dist/lib/slideshow/spec.js.map +1 -1
  61. package/dist/lib/slideshow-pacing.d.ts +46 -0
  62. package/dist/lib/slideshow-pacing.d.ts.map +1 -0
  63. package/dist/lib/slideshow-pacing.js +98 -0
  64. package/dist/lib/slideshow-pacing.js.map +1 -0
  65. package/dist/mcp/index.d.ts +12023 -800
  66. package/dist/mcp/index.d.ts.map +1 -1
  67. package/dist/mcp/index.js +593 -13
  68. package/dist/mcp/index.js.map +1 -1
  69. package/dist/mcp/tools/ai-visibility.d.ts +18 -0
  70. package/dist/mcp/tools/ai-visibility.d.ts.map +1 -0
  71. package/dist/mcp/tools/ai-visibility.js +124 -0
  72. package/dist/mcp/tools/ai-visibility.js.map +1 -0
  73. package/dist/mcp/tools/budget.d.ts +35 -0
  74. package/dist/mcp/tools/budget.d.ts.map +1 -0
  75. package/dist/mcp/tools/budget.js +205 -0
  76. package/dist/mcp/tools/budget.js.map +1 -0
  77. package/dist/mcp/tools/creative-drafts.d.ts +16 -2
  78. package/dist/mcp/tools/creative-drafts.d.ts.map +1 -1
  79. package/dist/mcp/tools/creative-drafts.js +237 -31
  80. package/dist/mcp/tools/creative-drafts.js.map +1 -1
  81. package/dist/mcp/tools/creatives.d.ts +12 -3
  82. package/dist/mcp/tools/creatives.d.ts.map +1 -1
  83. package/dist/mcp/tools/creatives.js +235 -17
  84. package/dist/mcp/tools/creatives.js.map +1 -1
  85. package/dist/mcp/tools/creators.d.ts +15 -0
  86. package/dist/mcp/tools/creators.d.ts.map +1 -0
  87. package/dist/mcp/tools/creators.js +69 -0
  88. package/dist/mcp/tools/creators.js.map +1 -0
  89. package/dist/mcp/tools/growth-signals.d.ts +38 -0
  90. package/dist/mcp/tools/growth-signals.d.ts.map +1 -0
  91. package/dist/mcp/tools/growth-signals.js +135 -0
  92. package/dist/mcp/tools/growth-signals.js.map +1 -0
  93. package/dist/mcp/tools/insights.d.ts +9 -0
  94. package/dist/mcp/tools/insights.d.ts.map +1 -1
  95. package/dist/mcp/tools/insights.js +6 -1
  96. package/dist/mcp/tools/insights.js.map +1 -1
  97. package/dist/mcp/tools/links.d.ts +26 -0
  98. package/dist/mcp/tools/links.d.ts.map +1 -0
  99. package/dist/mcp/tools/links.js +92 -0
  100. package/dist/mcp/tools/links.js.map +1 -0
  101. package/dist/mcp/tools/marketing-changes.d.ts +25 -0
  102. package/dist/mcp/tools/marketing-changes.d.ts.map +1 -0
  103. package/dist/mcp/tools/marketing-changes.js +108 -0
  104. package/dist/mcp/tools/marketing-changes.js.map +1 -0
  105. package/dist/mcp/tools/marketing-definitions.d.ts +11 -0
  106. package/dist/mcp/tools/marketing-definitions.d.ts.map +1 -0
  107. package/dist/mcp/tools/marketing-definitions.js +37 -0
  108. package/dist/mcp/tools/marketing-definitions.js.map +1 -0
  109. package/dist/mcp/tools/marketing-report.d.ts +7 -0
  110. package/dist/mcp/tools/marketing-report.d.ts.map +1 -1
  111. package/dist/mcp/tools/marketing-report.js +43 -5
  112. package/dist/mcp/tools/marketing-report.js.map +1 -1
  113. package/dist/mcp/tools/posts.d.ts.map +1 -1
  114. package/dist/mcp/tools/posts.js +16 -0
  115. package/dist/mcp/tools/posts.js.map +1 -1
  116. package/dist/mcp/tools/promises.d.ts +39 -0
  117. package/dist/mcp/tools/promises.d.ts.map +1 -0
  118. package/dist/mcp/tools/promises.js +98 -0
  119. package/dist/mcp/tools/promises.js.map +1 -0
  120. package/dist/mcp/tools/proposals.d.ts +26 -0
  121. package/dist/mcp/tools/proposals.d.ts.map +1 -0
  122. package/dist/mcp/tools/proposals.js +102 -0
  123. package/dist/mcp/tools/proposals.js.map +1 -0
  124. package/dist/mcp/tools/safe-zone-pixels.d.ts +165 -0
  125. package/dist/mcp/tools/safe-zone-pixels.d.ts.map +1 -0
  126. package/dist/mcp/tools/safe-zone-pixels.js +300 -0
  127. package/dist/mcp/tools/safe-zone-pixels.js.map +1 -0
  128. package/dist/mcp/tools/slideshow-render.d.ts.map +1 -1
  129. package/dist/mcp/tools/slideshow-render.js +3 -1
  130. package/dist/mcp/tools/slideshow-render.js.map +1 -1
  131. package/dist/mcp/tools/switchback.d.ts +36 -0
  132. package/dist/mcp/tools/switchback.d.ts.map +1 -0
  133. package/dist/mcp/tools/switchback.js +123 -0
  134. package/dist/mcp/tools/switchback.js.map +1 -0
  135. package/dist/mcp/tools/verification.d.ts +24 -0
  136. package/dist/mcp/tools/verification.d.ts.map +1 -0
  137. package/dist/mcp/tools/verification.js +124 -0
  138. package/dist/mcp/tools/verification.js.map +1 -0
  139. package/package.json +4 -2
@@ -0,0 +1 @@
1
+ {"version":3,"file":"promises.js","sourceRoot":"","sources":["../../../src/mcp/tools/promises.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErD;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,CAAU,CAAA;AACxG,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAA;AAC9B,MAAM,CAAC,MAAM,OAAO,GAAG,GAAG,CAAA;AAC1B,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAA;AAE5B,MAAM,IAAI,GAAG,qBAAqB,CAAA;AAuClC,MAAM,GAAG,GAAG,CAAC,QAAgB,EAAU,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAA;AAE1E,kFAAkF;AAClF,MAAM,UAAU,UAAU,CAAC,IAAgC;IACzD,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA;IACtB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAA;IAChD,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,CAAA;AACnG,CAAC;AAED,SAAS,SAAS,CAAC,IAAwB;IACzC,MAAM,UAAU,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IACpD,IAAI,CAAE,YAAkC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CAAC,6BAA6B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACzE,CAAC;IACD,OAAO,UAAU,CAAA;AACnB,CAAC;AAED,SAAS,QAAQ,CAAC,GAAuB;IACvC,MAAM,OAAO,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IACzD,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,OAAO,aAAa,CAAC,CAAA;IACpH,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,KAAyB;IACxD,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,qBAAqB,CAAC,CAAA;AAC7F,CAAC;AAWD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAc,EAAE,CAAmB;IAClE,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IACrE,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,WAAW;QAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,WAAW,aAAa,CAAC,CAAA;IAC1H,MAAM,UAAU,GAAG,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAA;IAC1C,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IACvC,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,SAAS,aAAa,CAAC,CAAA;IAEzH,MAAM,KAAK,GAAG,MAAM,MAAM,CACxB,oBAAoB,MAAM,CAAC,SAAS,yBAAyB,EAC7D,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,EAC7D,MAAM,CACP,CAAA;IACD,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,QAAQ,EAAE,sFAAsF;KACjG,CAAA;AACH,CAAC;AASD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAc,EAAE,CAAqB;IACtE,MAAM,UAAU,GAAG,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAA;IAC1C,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IACvC,MAAM,SAAS,CACb,oBAAoB,MAAM,CAAC,SAAS,sCAAsC,UAAU,cAAc,kBAAkB,CAAC,SAAS,CAAC,EAAE,EACjI,MAAM,CACP,CAAA;IACD,OAAO;QACL,UAAU;QACV,SAAS;QACT,IAAI,EAAE,yEAAyE;QAC/E,QAAQ,EAAE,+CAA+C;KAC1D,CAAA;AACH,CAAC;AASD,SAAS,cAAc,CAAC,CAAa;IACnC,MAAM,GAAG,GAAG,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAC9G,OAAO;QACL,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE;QACxB,wEAAwE;QACxE,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,IAAI;QAC5B,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,SAAS,EAAE,GAAG;QACd,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;QAClC,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QACpB,WAAW,EAAE,CAAC,CAAC,MAAM,KAAK,IAAI;QAC9B,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5D,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAc,EAAE,CAAqB;IACtE,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAA;IACzB,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAA;IACrB,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAClG,MAAM,MAAM,GAAG,MAAM,MAAM,CACzB,oBAAoB,MAAM,CAAC,SAAS,sBAAsB,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EACpF,MAAM,CACP,CAAA;IACD,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;IAC5D,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,QAAQ;QACR,GAAG,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;YACvB,CAAC,CAAC,EAAE,IAAI,EAAE,iHAAiH,EAAE;YAC7H,CAAC,CAAC,EAAE,CAAC;KACR,CAAA;AACH,CAAC"}
@@ -0,0 +1,26 @@
1
+ import { Config } from '../config.js';
2
+ /**
3
+ * Weekly growth proposals (`/marketing/proposals`) and the workflow that makes them
4
+ * (`/marketing/weekly-growth/install`). A proposal is a PLANNED change on the MARKETING_CHANGES workflow: the server
5
+ * refuses a signal the verification ledger has not verified and a fourth proposal in an ISO week, and a person moves
6
+ * a change to LIVE. This file only checks what can be checked without the server (shape, duplicates, dates) so a
7
+ * malformed call costs no round trip; the evidence rules stay on the server, whose reason is passed through as is.
8
+ */
9
+ export declare const SIGNALS_PER_PROPOSAL = 2;
10
+ export interface ProposalSignal {
11
+ metricRef: string;
12
+ window: string;
13
+ value: number;
14
+ note?: string;
15
+ }
16
+ export interface ProposeMarketingChangeParams {
17
+ title: string;
18
+ type: string;
19
+ hypothesis: string;
20
+ reviewOn: string;
21
+ signals: ProposalSignal[];
22
+ runId?: string;
23
+ }
24
+ export declare function proposeMarketingChange(config: Config, p: ProposeMarketingChangeParams): Promise<Record<string, unknown>>;
25
+ export declare function installWeeklyGrowthWorkflow(config: Config): Promise<Record<string, unknown>>;
26
+ //# sourceMappingURL=proposals.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"proposals.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/proposals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAGrC;;;;;;GAMG;AAEH,eAAO,MAAM,oBAAoB,IAAI,CAAA;AAKrC,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAuDD,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,CAAC,EAAE,4BAA4B,GAC9B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA6BlC;AAED,wBAAsB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAsBlG"}
@@ -0,0 +1,102 @@
1
+ import { apiPost, apiPostWithStatus } from '../api.js';
2
+ /**
3
+ * Weekly growth proposals (`/marketing/proposals`) and the workflow that makes them
4
+ * (`/marketing/weekly-growth/install`). A proposal is a PLANNED change on the MARKETING_CHANGES workflow: the server
5
+ * refuses a signal the verification ledger has not verified and a fourth proposal in an ISO week, and a person moves
6
+ * a change to LIVE. This file only checks what can be checked without the server (shape, duplicates, dates) so a
7
+ * malformed call costs no round trip; the evidence rules stay on the server, whose reason is passed through as is.
8
+ */
9
+ export const SIGNALS_PER_PROPOSAL = 2;
10
+ const WINDOW = /^(?:7d|28d|90d|\d{4}-\d{2}-\d{2}\.\.\d{4}-\d{2}-\d{2})$/;
11
+ const DAY = /^\d{4}-\d{2}-\d{2}$/;
12
+ function text(name, value) {
13
+ const trimmed = typeof value === 'string' ? value.trim() : '';
14
+ if (!trimmed)
15
+ throw new Error(`${name} is required`);
16
+ return trimmed;
17
+ }
18
+ function isRealDay(day) {
19
+ if (!DAY.test(day))
20
+ return false;
21
+ const parsed = new Date(`${day}T00:00:00Z`);
22
+ return !Number.isNaN(parsed.getTime()) && parsed.toISOString().slice(0, 10) === day;
23
+ }
24
+ /** The metric with its channel upper-cased, the way the server compares two metrics. */
25
+ function normalizedRef(ref) {
26
+ const dot = ref.indexOf('.');
27
+ return ref.slice(0, dot).toUpperCase() + ref.slice(dot);
28
+ }
29
+ function checkedSignal(index, raw) {
30
+ const at = `signals[${index}]`;
31
+ const s = (raw ?? {});
32
+ const metricRef = typeof s.metricRef === 'string' ? s.metricRef.trim() : '';
33
+ const dot = metricRef.indexOf('.');
34
+ if (dot < 1 || dot === metricRef.length - 1) {
35
+ throw new Error(`${at}.metricRef must look like CHANNEL.metric, for example ADS.installs`);
36
+ }
37
+ const window = typeof s.window === 'string' ? s.window.trim() : '';
38
+ if (!WINDOW.test(window)) {
39
+ throw new Error(`${at}.window must be 7d, 28d, 90d or a range YYYY-MM-DD..YYYY-MM-DD`);
40
+ }
41
+ if (typeof s.value !== 'number' || !Number.isFinite(s.value)) {
42
+ throw new Error(`${at}.value must be the ledger's figure for that window, a number`);
43
+ }
44
+ const out = { metricRef, window, value: s.value };
45
+ const note = typeof s.note === 'string' ? s.note.trim() : '';
46
+ if (note)
47
+ out['note'] = note;
48
+ return out;
49
+ }
50
+ export async function proposeMarketingChange(config, p) {
51
+ const title = text('title', p.title);
52
+ const type = text('type', p.type);
53
+ const hypothesis = text('hypothesis', p.hypothesis);
54
+ const reviewOn = typeof p.reviewOn === 'string' ? p.reviewOn.trim() : '';
55
+ if (!isRealDay(reviewOn))
56
+ throw new Error('reviewOn must be the day to review the result, YYYY-MM-DD, after today');
57
+ if (!Array.isArray(p.signals) || p.signals.length !== SIGNALS_PER_PROPOSAL) {
58
+ const got = Array.isArray(p.signals) ? p.signals.length : 0;
59
+ throw new Error(`A proposal needs exactly ${SIGNALS_PER_PROPOSAL} signals on different metrics; got ${got}`);
60
+ }
61
+ const signals = p.signals.map((s, i) => checkedSignal(i, s));
62
+ const refs = signals.map((s) => normalizedRef(s['metricRef']));
63
+ if (refs[0] === refs[1]) {
64
+ throw new Error(`The two signals must be on different metrics; ${refs[0]} appears twice`);
65
+ }
66
+ const body = { title, type, hypothesis, reviewOn, signals };
67
+ const runId = typeof p.runId === 'string' ? p.runId.trim() : '';
68
+ if (runId)
69
+ body['runId'] = runId;
70
+ const made = await apiPost(`/api/v2/projects/${config.projectId}/marketing/proposals`, body, config);
71
+ return {
72
+ proposed: true,
73
+ workItemId: made.workItemId,
74
+ displayId: made.displayId,
75
+ status: 'PLANNED',
76
+ proposalsThisWeek: made.proposalsThisWeek,
77
+ weeklyLimit: made.weeklyLimit,
78
+ next: 'A person reviews it and marks it live or abandons it; this tool cannot. Nothing was changed on any ad platform.',
79
+ };
80
+ }
81
+ export async function installWeeklyGrowthWorkflow(config) {
82
+ const { data } = await apiPostWithStatus(`/api/v2/projects/${config.projectId}/marketing/weekly-growth/install`, {}, config);
83
+ const out = {
84
+ installed: data.created,
85
+ workflowId: data.workflowId,
86
+ name: data.name,
87
+ enabled: data.enabled,
88
+ };
89
+ if (data.created) {
90
+ out['next'] =
91
+ 'Installed disabled, so nothing runs yet. Set a runtime target for Claude Code steps (Settings > AI Providers > Runtime), then a person enables it under Workflows.';
92
+ }
93
+ else if (data.enabled) {
94
+ out['next'] = 'A workflow with this name was already there and is enabled; it was left unchanged.';
95
+ }
96
+ else {
97
+ out['next'] =
98
+ 'A workflow with this name was already there and is still disabled; it was left unchanged. A person enables it under Workflows once a runtime target for Claude Code steps is set.';
99
+ }
100
+ return out;
101
+ }
102
+ //# sourceMappingURL=proposals.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"proposals.js","sourceRoot":"","sources":["../../../src/mcp/tools/proposals.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,165 @@
1
+ import type { DraftCheck } from '../../lib/creative-render.js';
2
+ import { type SampledFrame } from '../../lib/safe-zone/frames.js';
3
+ import type { OcrEngine } from '../../lib/safe-zone/ocr.js';
4
+ import { type OverlayFrame, type OverlayPlatform } from '../../lib/safe-zone/overlay.js';
5
+ import type { BrowserFactory } from '../../lib/creative-browser.js';
6
+ import { CROSSFADE_SEC, isDetailSlide, totalSeconds } from '../../lib/slideshow-pacing.js';
7
+ /**
8
+ * Shared by preview_creative_draft, preview_creative, attach_creative_to_post, render_creative and
9
+ * create_creative/update_creative: the finished-pixel safe-zone check, the platform-UI overlay sheets
10
+ * and the reading-based slide pacing. Tests inject fakes through PixelToolOptions so neither tesseract
11
+ * nor a browser is needed.
12
+ */
13
+ /** The largest push-in of the slideshow's Ken Burns zoom (conductor-creative/job/media.mjs: z = 1 + 0.06 x progress). */
14
+ export declare const SLIDESHOW_ZOOM_MAX = 1.06;
15
+ export declare const MAX_INLINE_BYTES = 1000000;
16
+ export type UiOverlay = 'instagram' | 'tiktok' | 'both' | 'none';
17
+ export interface OverlaySheet {
18
+ platform: OverlayPlatform;
19
+ file: string;
20
+ placementKey?: string;
21
+ }
22
+ export type OverlayWriter = (frames: OverlayFrame[], platforms: OverlayPlatform[], outDir: string, baseName: string, opts?: {
23
+ maxPerSheet?: number;
24
+ browser?: BrowserFactory;
25
+ }) => Promise<Array<{
26
+ platform: OverlayPlatform;
27
+ file: string;
28
+ bytes?: number;
29
+ }>>;
30
+ export interface PixelToolOptions {
31
+ /** OCR engine override (tests). Default: the shared tesseract worker. */
32
+ ocrEngine?: OcrEngine;
33
+ /** Video frame sampler override (tests). Default: ffmpeg. */
34
+ sampler?: (videoPath: string) => Promise<SampledFrame[]>;
35
+ /** Overlay sheet writer override (tests). Default: Playwright. */
36
+ overlay?: OverlayWriter;
37
+ /** Browser launcher shared by every overlay drawn in one tool call (set by withSharedOverlayBrowser). */
38
+ overlayBrowser?: BrowserFactory;
39
+ /** fetch override for downloading a saved Creative's media (tests). */
40
+ fetchImpl?: typeof fetch;
41
+ }
42
+ export declare const hasErrors: (checks: DraftCheck[]) => boolean;
43
+ export declare function platformsFor(ui: UiOverlay | undefined): OverlayPlatform[];
44
+ /** Writes the overlay sheets; never throws (no browser is a note, not a failure). */
45
+ export declare function writeOverlaySheets(frames: OverlayFrame[], platforms: OverlayPlatform[], outDir: string, baseName: string, placementKey: string, opts: PixelToolOptions): Promise<{
46
+ sheets: OverlaySheet[];
47
+ note?: string;
48
+ }>;
49
+ /**
50
+ * Runs one tool call with a single lazily launched browser shared by all its overlay sheets (every
51
+ * platform and placement), closed when the call ends. A test-injected `overlay` writer is left alone.
52
+ */
53
+ export declare function withSharedOverlayBrowser<T, O extends PixelToolOptions>(options: O, fn: (options: O) => Promise<T>): Promise<T>;
54
+ /** The one image to inline: the Instagram sheet (else the first), unless it is too large. */
55
+ export declare function inlineOverlay(sheets: OverlaySheet[]): Promise<{
56
+ image?: {
57
+ data: Buffer;
58
+ mimeType: string;
59
+ };
60
+ note?: string;
61
+ }>;
62
+ export interface SlideInput {
63
+ /** Local file, when the slide is on this machine. */
64
+ path?: string;
65
+ /** Position in the slide list (0-based). */
66
+ index: number;
67
+ }
68
+ export interface SlidePixelResult {
69
+ checks: DraftCheck[];
70
+ overlaySheets: OverlaySheet[];
71
+ notes: string[];
72
+ }
73
+ /** Checks the 9:16 slides that are files on this machine, and draws the overlay for them. */
74
+ export declare function checkSlidesPixels(slides: SlideInput[], opts: PixelToolOptions & {
75
+ placementKey?: string;
76
+ zoom?: boolean;
77
+ outDir?: string;
78
+ baseName?: string;
79
+ uiOverlay?: UiOverlay;
80
+ }): Promise<SlidePixelResult>;
81
+ /** Frames for the overlay sheet: the ones nearest 0.5, 1.5 and 2.5 s, plus the first frame after each cut. */
82
+ export declare function clipOverlayFrames(sampled: SampledFrame[]): OverlayFrame[];
83
+ export interface ClipPixelResult {
84
+ checks: DraftCheck[];
85
+ overlaySheets: OverlaySheet[];
86
+ notes: string[];
87
+ }
88
+ /** Checks one 9:16 video for text under the platform UI and draws the overlay from its early frames and cuts. */
89
+ export declare function checkClipPixels(videoPath: string, opts: PixelToolOptions & {
90
+ placementKey?: string;
91
+ outDir?: string;
92
+ baseName?: string;
93
+ uiOverlay?: UiOverlay;
94
+ durationSeconds?: number;
95
+ }): Promise<ClipPixelResult>;
96
+ export interface SavedFrame {
97
+ placementKey: string;
98
+ sequenceIndex?: number | null;
99
+ url?: string;
100
+ durationSeconds?: number;
101
+ contentType?: string;
102
+ }
103
+ export interface SavedRender {
104
+ id: string;
105
+ state: string;
106
+ creativeVersion?: number;
107
+ previewOnly?: boolean;
108
+ frames?: SavedFrame[];
109
+ }
110
+ /** The render whose frames to check: the named one, else the latest SUCCEEDED full render (of `version` when known). */
111
+ export declare function pickRender(renders: SavedRender[], renderId?: string, version?: number): SavedRender | undefined;
112
+ export interface SavedPixelResult {
113
+ checks: DraftCheck[];
114
+ passed: boolean;
115
+ overlaySheets: OverlaySheet[];
116
+ notes: string[];
117
+ }
118
+ export declare function checkSavedCreativePixels(creative: {
119
+ kind?: string;
120
+ audio?: {
121
+ source?: string;
122
+ } | null;
123
+ slideshow?: {
124
+ zoom?: boolean;
125
+ } | null;
126
+ }, render: SavedRender | undefined, opts: PixelToolOptions & {
127
+ writeOverlay?: boolean;
128
+ uiOverlay?: UiOverlay;
129
+ outDir?: string;
130
+ }): Promise<{
131
+ result?: SavedPixelResult;
132
+ skipped?: string;
133
+ }>;
134
+ /** A short message listing the failing checks, for a refusal. */
135
+ export declare function describeChecks(checks: DraftCheck[]): string;
136
+ /** Makes sure a directory exists. */
137
+ export declare function ensureDir(dir: string): Promise<void>;
138
+ export interface PacingResult {
139
+ slideDurations: number[];
140
+ totalSeconds: number;
141
+ basis: 'altText' | 'ocr' | 'mixed' | 'none';
142
+ /** True when the tool computed the durations; false when the caller passed them. */
143
+ computed: boolean;
144
+ warnings: string[];
145
+ }
146
+ /**
147
+ * Per-slide durations from the on-slide words. A slide's words come from the "Text:" part of its alt text
148
+ * (`Text: none` means no words); without one, from OCR of the local slide when `ocr` is allowed.
149
+ * When `given` is passed the durations are kept and only the warnings are computed.
150
+ */
151
+ export declare function pacingFor(input: {
152
+ count: number;
153
+ altText?: string[];
154
+ /** Local file per slide index, when it is on this machine. */
155
+ paths?: Array<string | undefined>;
156
+ ocr?: boolean;
157
+ engine?: OcrEngine;
158
+ given?: number[];
159
+ }): Promise<PacingResult>;
160
+ /** True when a slideshow object already carries explicit durations. */
161
+ export declare function givenDurations(slideshow: unknown): number[] | undefined;
162
+ /** True when the audio of a CAROUSEL is a library or local track. */
163
+ export declare function hasTrack(audio: unknown): boolean;
164
+ export { CROSSFADE_SEC, isDetailSlide, totalSeconds };
165
+ //# sourceMappingURL=safe-zone-pixels.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"safe-zone-pixels.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/safe-zone-pixels.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,300 @@
1
+ import { mkdir, mkdtemp, readFile, rm, writeFile } from 'node:fs/promises';
2
+ import { tmpdir } from 'node:os';
3
+ import { join } from 'node:path';
4
+ import { readImageDimensions } from '../../lib/image-dimensions.js';
5
+ import { checkSlideImages, checkVideoFrames, ocrSlideWordCount, uncheckedCheck, } from '../../lib/safe-zone/check.js';
6
+ import { sampleVideoFrames } from '../../lib/safe-zone/frames.js';
7
+ import { overlaySheetsFor, sharedBrowser } from '../../lib/safe-zone/overlay.js';
8
+ import { CROSSFADE_SEC, isDetailSlide, pacingWarnings, paceSlides, slideTextFromAltText, totalSeconds, } from '../../lib/slideshow-pacing.js';
9
+ /**
10
+ * Shared by preview_creative_draft, preview_creative, attach_creative_to_post, render_creative and
11
+ * create_creative/update_creative: the finished-pixel safe-zone check, the platform-UI overlay sheets
12
+ * and the reading-based slide pacing. Tests inject fakes through PixelToolOptions so neither tesseract
13
+ * nor a browser is needed.
14
+ */
15
+ /** The largest push-in of the slideshow's Ken Burns zoom (conductor-creative/job/media.mjs: z = 1 + 0.06 x progress). */
16
+ export const SLIDESHOW_ZOOM_MAX = 1.06;
17
+ export const MAX_INLINE_BYTES = 1000000;
18
+ const OVERLAY_SLIDES_PER_SHEET = 10;
19
+ export const hasErrors = (checks) => checks.some((c) => c.severity === 'error');
20
+ export function platformsFor(ui) {
21
+ if (ui === 'none')
22
+ return [];
23
+ if (ui === 'instagram')
24
+ return ['instagram'];
25
+ if (ui === 'tiktok')
26
+ return ['tiktok'];
27
+ return ['instagram', 'tiktok'];
28
+ }
29
+ function isNineBySixteen(png) {
30
+ const d = readImageDimensions(png);
31
+ return !!d && Math.abs(d.width / d.height - 9 / 16) < 0.01;
32
+ }
33
+ /** Writes the overlay sheets; never throws (no browser is a note, not a failure). */
34
+ export async function writeOverlaySheets(frames, platforms, outDir, baseName, placementKey, opts) {
35
+ if (!platforms.length || !frames.length)
36
+ return { sheets: [] };
37
+ try {
38
+ const writer = opts.overlay ?? overlaySheetsFor;
39
+ const written = await writer(frames, platforms, outDir, baseName, {
40
+ maxPerSheet: OVERLAY_SLIDES_PER_SHEET,
41
+ ...(opts.overlayBrowser ? { browser: opts.overlayBrowser } : {}),
42
+ });
43
+ return { sheets: written.map((w) => ({ platform: w.platform, file: w.file, placementKey })) };
44
+ }
45
+ catch (e) {
46
+ return { sheets: [], note: `${placementKey}: could not draw the platform UI overlay (${e instanceof Error ? e.message : String(e)}).` };
47
+ }
48
+ }
49
+ /**
50
+ * Runs one tool call with a single lazily launched browser shared by all its overlay sheets (every
51
+ * platform and placement), closed when the call ends. A test-injected `overlay` writer is left alone.
52
+ */
53
+ export async function withSharedOverlayBrowser(options, fn) {
54
+ if (options.overlay || options.overlayBrowser)
55
+ return fn(options);
56
+ const shared = sharedBrowser();
57
+ try {
58
+ return await fn({ ...options, overlayBrowser: shared.factory });
59
+ }
60
+ finally {
61
+ await shared.closeAll();
62
+ }
63
+ }
64
+ /** The one image to inline: the Instagram sheet (else the first), unless it is too large. */
65
+ export async function inlineOverlay(sheets) {
66
+ const pick = sheets.find((s) => s.platform === 'instagram') ?? sheets[0];
67
+ if (!pick)
68
+ return {};
69
+ try {
70
+ const data = await readFile(pick.file);
71
+ if (data.byteLength > MAX_INLINE_BYTES)
72
+ return { note: `The UI overlay sheet is larger than this tool can inline (~1 MB) — open ${pick.file} directly.` };
73
+ return { image: { data, mimeType: 'image/jpeg' } };
74
+ }
75
+ catch {
76
+ return {};
77
+ }
78
+ }
79
+ /** Checks the 9:16 slides that are files on this machine, and draws the overlay for them. */
80
+ export async function checkSlidesPixels(slides, opts) {
81
+ const placementKey = opts.placementKey ?? '9x16';
82
+ const notes = [];
83
+ const local = slides.filter((s) => !!s.path);
84
+ const missing = slides.filter((s) => !s.path);
85
+ const checks = local.length
86
+ ? await checkSlideImages(local.map((s) => ({ path: s.path, index: s.index })), {
87
+ placementKey,
88
+ ...(opts.zoom ? { zoom: { maxScale: SLIDESHOW_ZOOM_MAX } } : {}),
89
+ ...(opts.ocrEngine ? { engine: opts.ocrEngine } : {}),
90
+ })
91
+ : [];
92
+ if (missing.length) {
93
+ checks.push(uncheckedCheck(placementKey, `slide${missing.length === 1 ? '' : 's'} ${missing.map((m) => m.index + 1).join(', ')} ${missing.length === 1 ? 'is' : 'are'} existing media, not a file on this machine`));
94
+ }
95
+ let overlaySheets = [];
96
+ const platforms = platformsFor(opts.uiOverlay);
97
+ if (opts.outDir && platforms.length && local.length) {
98
+ const frames = [];
99
+ for (const s of local) {
100
+ try {
101
+ const bytes = await readFile(s.path);
102
+ if (isNineBySixteen(bytes))
103
+ frames.push({ png: bytes, label: `Slide ${s.index + 1}` });
104
+ }
105
+ catch {
106
+ /* the check already reported the unreadable file */
107
+ }
108
+ }
109
+ const written = await writeOverlaySheets(frames, platforms, opts.outDir, opts.baseName ?? `overlay-${placementKey}`, placementKey, opts);
110
+ overlaySheets = written.sheets;
111
+ if (written.note)
112
+ notes.push(written.note);
113
+ if (frames.length > OVERLAY_SLIDES_PER_SHEET && written.sheets.length) {
114
+ notes.push(`The UI overlay shows the first ${OVERLAY_SLIDES_PER_SHEET} of ${frames.length} slides.`);
115
+ }
116
+ }
117
+ return { checks, overlaySheets, notes };
118
+ }
119
+ // --- Clips -------------------------------------------------------------------------
120
+ const EARLY_TARGETS = [0.5, 1.5, 2.5];
121
+ const MAX_OVERLAY_FRAMES = 10;
122
+ /** Frames for the overlay sheet: the ones nearest 0.5, 1.5 and 2.5 s, plus the first frame after each cut. */
123
+ export function clipOverlayFrames(sampled) {
124
+ const picked = new Map();
125
+ for (const target of EARLY_TARGETS) {
126
+ let best;
127
+ for (const f of sampled)
128
+ if (!best || Math.abs(f.atSeconds - target) < Math.abs(best.atSeconds - target))
129
+ best = f;
130
+ if (best && Math.abs(best.atSeconds - target) <= 0.5 && !picked.has(best.atSeconds)) {
131
+ picked.set(best.atSeconds, { frame: best, label: `${target} s`, cut: false });
132
+ }
133
+ }
134
+ const cuts = sampled.filter((f) => f.isCut);
135
+ for (const f of cuts)
136
+ picked.set(f.atSeconds, { frame: f, label: `Cut at ${f.atSeconds.toFixed(1)} s`, cut: true });
137
+ const all = [...picked.values()].sort((a, b) => a.frame.atSeconds - b.frame.atSeconds);
138
+ // Over the cap, keep the early frames and the earliest cuts.
139
+ const keep = all.length > MAX_OVERLAY_FRAMES ? [...all.filter((p) => !p.cut), ...all.filter((p) => p.cut)].slice(0, MAX_OVERLAY_FRAMES).sort((a, b) => a.frame.atSeconds - b.frame.atSeconds) : all;
140
+ return keep.map((p) => ({ png: p.frame.png, label: p.label }));
141
+ }
142
+ /** Checks one 9:16 video for text under the platform UI and draws the overlay from its early frames and cuts. */
143
+ export async function checkClipPixels(videoPath, opts) {
144
+ const placementKey = opts.placementKey ?? '9x16';
145
+ const notes = [];
146
+ let sampled = [];
147
+ const base = opts.sampler ?? ((p) => sampleVideoFrames(p, opts.durationSeconds ? { durationSeconds: opts.durationSeconds } : {}));
148
+ const checks = await checkVideoFrames(videoPath, {
149
+ placementKey,
150
+ ...(opts.ocrEngine ? { engine: opts.ocrEngine } : {}),
151
+ sampler: async (p) => {
152
+ sampled = await base(p);
153
+ return sampled;
154
+ },
155
+ });
156
+ let overlaySheets = [];
157
+ const platforms = platformsFor(opts.uiOverlay);
158
+ if (opts.outDir && platforms.length && sampled.length) {
159
+ const frames = clipOverlayFrames(sampled.filter((f) => isNineBySixteen(f.png)));
160
+ const written = await writeOverlaySheets(frames, platforms, opts.outDir, opts.baseName ?? `overlay-${placementKey}`, placementKey, opts);
161
+ overlaySheets = written.sheets;
162
+ if (written.note)
163
+ notes.push(written.note);
164
+ }
165
+ return { checks, overlaySheets, notes };
166
+ }
167
+ const isVideoFrame = (f) => f.durationSeconds != null || (f.contentType ?? '').startsWith('video/');
168
+ /** The render whose frames to check: the named one, else the latest SUCCEEDED full render (of `version` when known). */
169
+ export function pickRender(renders, renderId, version) {
170
+ if (renderId)
171
+ return renders.find((r) => r.id === renderId);
172
+ return renders.find((r) => r.state === 'SUCCEEDED' && !r.previewOnly && (version === undefined || r.creativeVersion === undefined || r.creativeVersion === version));
173
+ }
174
+ /**
175
+ * Downloads a saved CAROUSEL's 9x16 slides or CLIP's 9x16 video from a render's signed URLs and runs the
176
+ * same pixel check as the draft. Returns undefined when there is nothing to check (another kind, no 9x16
177
+ * frames, or no render yet), with the reason in `skipped`.
178
+ */
179
+ /** `<tmp>/conductor-safezone/<renderId>`, emptied. The id is reduced to safe characters for the path. */
180
+ async function freshRenderDir(renderId) {
181
+ const dir = join(tmpdir(), 'conductor-safezone', String(renderId).replace(/[^A-Za-z0-9_-]/g, '_') || 'render');
182
+ await rm(dir, { recursive: true, force: true });
183
+ await mkdir(dir, { recursive: true });
184
+ return dir;
185
+ }
186
+ export async function checkSavedCreativePixels(creative, render, opts) {
187
+ const kind = creative.kind;
188
+ if (kind !== 'CAROUSEL' && kind !== 'CLIP')
189
+ return { skipped: 'not a CAROUSEL or CLIP' };
190
+ if (!render)
191
+ return { skipped: 'no full render yet — call render_creative first' };
192
+ const frames = (render.frames ?? []).filter((f) => f.placementKey === '9x16' && f.url);
193
+ const wanted = kind === 'CAROUSEL'
194
+ ? frames.filter((f) => !isVideoFrame(f)).sort((a, b) => (a.sequenceIndex ?? 0) - (b.sequenceIndex ?? 0))
195
+ : frames.filter(isVideoFrame).slice(0, 1);
196
+ if (!wanted.length)
197
+ return { skipped: 'no 9x16 placement to check' };
198
+ const fetchImpl = opts.fetchImpl ?? fetch;
199
+ // The overlay sheets' paths are returned to the caller, so a folder we created must outlive this call.
200
+ // It is one folder per render, emptied on each call, so repeated previews of a render never pile up;
201
+ // it is removed below when nothing was written into it.
202
+ const madeOutDir = !opts.outDir && opts.writeOverlay;
203
+ const outDir = opts.outDir ?? (madeOutDir ? await freshRenderDir(render.id) : undefined);
204
+ let keepOutDir = false;
205
+ const work = await mkdtemp(join(tmpdir(), 'conductor-safezone-media-'));
206
+ try {
207
+ const files = [];
208
+ for (const [i, f] of wanted.entries()) {
209
+ const res = await fetchImpl(f.url);
210
+ if (!res.ok)
211
+ throw new Error(`could not download ${f.placementKey} ${kind === 'CLIP' ? 'video' : `slide ${i + 1}`} (HTTP ${res.status})`);
212
+ const path = join(work, kind === 'CLIP' ? 'clip.mp4' : `slide-${i + 1}.${(f.contentType ?? '').includes('png') ? 'png' : 'jpg'}`);
213
+ await writeFile(path, Buffer.from(await res.arrayBuffer()));
214
+ files.push({ path, index: kind === 'CAROUSEL' ? (f.sequenceIndex ?? i) : 0 });
215
+ }
216
+ const common = { ...opts, ...(opts.writeOverlay && outDir ? { outDir } : {}), uiOverlay: opts.uiOverlay };
217
+ const zoom = kind === 'CAROUSEL' && creative.audio?.source === 'track' && creative.slideshow?.zoom !== false;
218
+ const r = kind === 'CAROUSEL'
219
+ ? await checkSlidesPixels(files, { ...common, zoom })
220
+ : await checkClipPixels(files[0].path, common);
221
+ keepOutDir = r.overlaySheets.length > 0;
222
+ return { result: { checks: r.checks, passed: !hasErrors(r.checks), overlaySheets: r.overlaySheets, notes: r.notes } };
223
+ }
224
+ catch (e) {
225
+ const checks = [uncheckedCheck('9x16', e instanceof Error ? e.message : String(e))];
226
+ return { result: { checks, passed: true, overlaySheets: [], notes: [] } };
227
+ }
228
+ finally {
229
+ await rm(work, { recursive: true, force: true }).catch(() => { });
230
+ if (madeOutDir && outDir && !keepOutDir)
231
+ await rm(outDir, { recursive: true, force: true }).catch(() => { });
232
+ }
233
+ }
234
+ /** A short message listing the failing checks, for a refusal. */
235
+ export function describeChecks(checks) {
236
+ return checks.map((c) => `${c.placementKey}${c.index !== undefined ? `[${c.index}]` : ''}: ${c.message}`).join('; ');
237
+ }
238
+ /** Makes sure a directory exists. */
239
+ export async function ensureDir(dir) {
240
+ await mkdir(dir, { recursive: true });
241
+ }
242
+ const TEXT_NONE = /\btext\s*:\s*none\b/i;
243
+ /**
244
+ * Per-slide durations from the on-slide words. A slide's words come from the "Text:" part of its alt text
245
+ * (`Text: none` means no words); without one, from OCR of the local slide when `ocr` is allowed.
246
+ * When `given` is passed the durations are kept and only the warnings are computed.
247
+ */
248
+ export async function pacingFor(input) {
249
+ const slides = [];
250
+ const bases = new Set();
251
+ for (let i = 0; i < input.count; i++) {
252
+ const alt = input.altText?.[i];
253
+ const slide = { ...(alt ? { altText: alt } : {}) };
254
+ if (alt && TEXT_NONE.test(alt)) {
255
+ slide.words = 0;
256
+ slide.lines = 0;
257
+ bases.add('altText');
258
+ }
259
+ else if (slideTextFromAltText(alt))
260
+ bases.add('altText');
261
+ else if (input.ocr && input.paths?.[i]) {
262
+ try {
263
+ const counted = await ocrSlideWordCount(input.paths[i], input.engine);
264
+ slide.words = counted.words;
265
+ slide.lines = counted.lines;
266
+ bases.add('ocr');
267
+ }
268
+ catch {
269
+ bases.add('none');
270
+ }
271
+ }
272
+ else
273
+ bases.add('none');
274
+ slides.push(slide);
275
+ }
276
+ const basis = bases.size === 1 ? [...bases][0] : 'mixed';
277
+ if (input.given) {
278
+ return {
279
+ slideDurations: input.given,
280
+ totalSeconds: totalSeconds(input.given),
281
+ basis,
282
+ computed: false,
283
+ warnings: pacingWarnings(input.given, slides),
284
+ };
285
+ }
286
+ const paced = paceSlides(slides);
287
+ return { slideDurations: paced.slideDurations, totalSeconds: paced.totalSeconds, basis, computed: true, warnings: [] };
288
+ }
289
+ /** True when a slideshow object already carries explicit durations. */
290
+ export function givenDurations(slideshow) {
291
+ const d = slideshow?.slideDurations;
292
+ return Array.isArray(d) && d.length && d.every((n) => typeof n === 'number') ? d : undefined;
293
+ }
294
+ /** True when the audio of a CAROUSEL is a library or local track. */
295
+ export function hasTrack(audio) {
296
+ const a = audio;
297
+ return a?.source === 'track';
298
+ }
299
+ export { CROSSFADE_SEC, isDetailSlide, totalSeconds };
300
+ //# sourceMappingURL=safe-zone-pixels.js.map