@taloswork/ose-shared 0.1.4 → 0.1.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taloswork/ose-shared",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Talos cross-OSE shared library — skills + MCP servers auto-loaded into every OSE (P93 2026-07-27).",
   "type": "module",
   "files": [
@@ -10,6 +10,6 @@
   "publishConfig": {
     "access": "public"
   },
-  "_talosPublishHash": "sha256-7or_mcdSHbKlZLnkDnnjf-71hdL7A895HrWVqUGALOo",
-  "_talosPublishedAt": "2026-09-03T17:22:12.823Z"
+  "_talosPublishHash": "sha256-CLI4WbNNvJRRbZYx7qniS0d-cVs5XiJlcU904jHxDww",
+  "_talosPublishedAt": "2026-09-06T18:53:54.545Z"
 }

package/skills/document/bin/html2pptx.cjs

@@ -147660,6 +147660,7 @@ async function imagesToPptx(imagesBase64Png) {
 }
 
 // packages/core/dist/document/html-pptx-walker.js
+var DOCUMENT_CAPTURE_DENSITY = 2;
 var LAYOUT_WALKER_JS = `
 (() => {
   const sections = [...document.querySelectorAll("section.slide")];
@@ -148118,13 +148119,22 @@ async function withHeadlessPage(html, fn) {
   if (!chromium) return null;
   const browser2 = await chromium.launch();
   try {
-    const page = await browser2.newPage({ viewport: { width: 1280, height: 720 } });
+    const page = await browser2.newPage({
+      viewport: { width: 1280, height: 720 },
+      deviceScaleFactor: DOCUMENT_CAPTURE_DENSITY
+    });
     await page.setContent(html, { waitUntil: "load" });
     await page.evaluate("document.fonts && document.fonts.ready").catch(() => {
     });
     const adapter = {
       evaluate: (script) => page.evaluate(script),
-      screenshot: (clip) => page.screenshot({ clip })
+      screenshot: async (clip) => {
+        const png = await page.screenshot({ clip });
+        const w = png.readUInt32BE(16), h = png.readUInt32BE(20);
+        const want = [clip.width * DOCUMENT_CAPTURE_DENSITY, clip.height * DOCUMENT_CAPTURE_DENSITY];
+        if (w !== want[0] || h !== want[1]) throw new Error(`captured ${w}x${h}, expected ${want[0]}x${want[1]}`);
+        return png;
+      }
     };
     return await fn(adapter);
   } finally {

package/skills/image-layout/LICENSE.txt

@@ -0,0 +1,30 @@
+© 2025 Anthropic, PBC. All rights reserved.
+
+LICENSE: Use of these materials (including all code, prompts, assets, files,
+and other components of this Skill) is governed by your agreement with
+Anthropic regarding use of Anthropic's services. If no separate agreement
+exists, use is governed by Anthropic's Consumer Terms of Service or
+Commercial Terms of Service, as applicable:
+https://www.anthropic.com/legal/consumer-terms
+https://www.anthropic.com/legal/commercial-terms
+Your applicable agreement is referred to as the "Agreement." "Services" are
+as defined in the Agreement.
+
+ADDITIONAL RESTRICTIONS: Notwithstanding anything in the Agreement to the
+contrary, users may not:
+
+- Extract these materials from the Services or retain copies of these
+  materials outside the Services
+- Reproduce or copy these materials, except for temporary copies created
+  automatically during authorized use of the Services
+- Create derivative works based on these materials
+- Distribute, sublicense, or transfer these materials to any third party
+- Make, offer to sell, sell, or import any inventions embodied in these
+  materials
+- Reverse engineer, decompile, or disassemble these materials
+
+The receipt, viewing, or possession of these materials does not convey or
+imply any license or right beyond those expressly granted above.
+
+Anthropic retains all right, title, and interest in these materials,
+including all copyrights, patents, and other intellectual property rights.

package/skills/image-layout/SKILL.md

@@ -0,0 +1,152 @@
+---
+name: image-layout
+description: "Use this skill whenever the user wants EXISTING images combined or altered as pixels — 拼图 / 拼接 / 拼一张 / 宫格 / 九宫格 / 长图 / 对比图 / 前后对比 / 加水印 / 加标签 / 加边框 / 裁剪 / 圆角 / 缩放, or stitch / combine / merge images / collage / contact sheet / side-by-side / before-after / watermark / label / crop / round corners / resize. Examples: 'combine these four into one picture', '把生成的几张图拼成九宫格', 'add a caption under each'. Method: HTML+CSS rendered by this skill's bin/html2img.cjs. The mechanical test: if the images do not exist as files yet, this is NOT the skill. Do NOT trigger for: generating NEW images, INCLUDING when the request names a layout word — '生成一张九宫格的图' asks for ONE generated picture whose COMPOSITION is a grid, not for tiling existing files; documents / PDF / PowerPoint (document skill); Xiaohongshu cards (talos-xhs-ops); or upscaling / background removal / content-aware fill, which need a model, not CSS."
+license: Proprietary. LICENSE.txt has complete terms
+---
+
+# Image layout
+
+Combining or restyling images that **already exist** — as files on disk. You
+write a layout in HTML+CSS; Chromium renders it to one PNG.
+
+**Check first: do the image files exist?** If they do not, stop — the request is
+for generation, not composition, and this skill cannot make imagery. A layout
+word in the request does not change that: "生成一张九宫格的图" asks for ONE
+generated picture whose composition happens to be a grid, the same way "three
+cats" describes a scene rather than an output count. Compose only files you can
+name a path for.
+
+There is no ImageMagick / sharp / PIL / ffmpeg to call here, and no `npm i`.
+Do not go looking for one, and do not ask a generation model to "draw a 2×2
+grid" — it redraws the subjects instead of tiling the images you have.
+
+## The one command
+
+```
+bin/html2img.cjs <in.html> <out.png> [--width N] [--max-height N]
+```
+
+- `--width` (default 1280) is the canvas width in CSS pixels. **You declare it**;
+  it must equal the sum of your columns plus gaps and padding.
+- The **height is measured** from the rendered page — never compute it. Captions
+  of any length, wrapped titles, variable rows all just work.
+- Local images referenced by `<img src>` and CSS `url()` are collected
+  automatically and allowlisted; relative paths resolve against the HTML file's
+  own directory, and any filename works, spaces and `~ % [ ]` included.
+  **Remote URLs are blocked**, and any image that fails to decode fails the whole
+  render — you never get a "finished" sheet with a blank cell in it.
+- Needs the Talos app (Chromium loopback). Headless it exits 69 with a clear
+  message; do not try to work around that.
+- Bounds: width 160–4096, rendered height ≤ `--max-height` (default 8192, refused
+  not cropped), ≤64 local images per render.
+- Output is always PNG.
+
+Then deliver the result with `present_file` — one call, the composed image.
+
+## Where the images are
+
+Pictures the user attached to the turn are **already on disk**: in `attachments/`
+relative to your working directory (the session workspace), named `image_0.png`,
+`image_1.png`, … — or by their original filename when they had one. The prompt
+also carries an `[Attachment on disk: <path>]` marker for each.
+
+```
+ls attachments/
+```
+
+Start there. **Do not scan the filesystem for them** (`find / -name "*.png"` and
+friends): it is slow, it burns the turn, and the answer was one `ls` away.
+Write your HTML in that same directory so the `<img src>` paths stay short.
+
+## Rules that keep the output right
+
+- **Give every cell an explicit pixel size.** The canvas width is arithmetic, and
+  arithmetic needs numbers: `cols × cell + (cols−1) × gap + 2 × padding`.
+- **CJK text must lead its font stack with `TalosCJK`**, e.g.
+  `font-family: TalosCJK, system-ui, sans-serif`. The renderer injects that face
+  when the HTML contains CJK; without it Chinese labels come out blank.
+- **Set an explicit `background`** on `body`. An unstyled page captures as white,
+  which is rarely what a dark sheet wants.
+- Write the HTML **next to the images**, or reference them by absolute path.
+- Source images keep their own resolution — a 1024px image in a 512px cell is
+  downscaled by the browser. Size cells for the output you want.
+
+## Recipes
+
+Each is a starting point; the layout is ordinary CSS, so change it freely.
+
+### Contact sheet / 宫格
+
+`cols × cell + (cols−1) × gap + 2 × pad`. Below: 2 × 512 + 20 + 48 = **1092**.
+
+```html
+<!doctype html><html><head><meta charset="utf-8"><style>
+  html,body{margin:0;background:#0d0d10}
+  body{font-family:TalosCJK,system-ui,-apple-system,sans-serif;color:#e8e8ea}
+  h1{margin:0;padding:24px 24px 8px;font-size:34px}
+  .sheet{display:grid;grid-template-columns:repeat(2,512px);gap:20px;padding:0 24px 24px}
+  figure{margin:0;position:relative}
+  figure img{width:512px;height:512px;object-fit:cover;display:block;border-radius:14px}
+  .tag{position:absolute;top:14px;left:14px;padding:6px 14px;border-radius:999px;
+       background:rgba(0,0,0,.55);font-size:20px;font-weight:600}
+  figcaption{padding-top:10px;font-size:20px;color:#c9c9d1;text-align:center}
+</style></head><body>
+  <h1>四个方案对比</h1>
+  <div class="sheet">
+    <figure><img src="a.png"><span class="tag">1</span><figcaption>方案 A</figcaption></figure>
+    <figure><img src="b.png"><span class="tag">2</span><figcaption>方案 B</figcaption></figure>
+  </div>
+</body></html>
+```
+
+### Long strip / 长图
+
+One column; the height takes care of itself.
+
+```css
+.strip{display:grid;grid-template-columns:1080px;gap:0;padding:0}
+.strip img{width:1080px;height:auto;display:block}
+```
+
+### Before / after
+
+Two cells with labels, or one cell with the "after" clipped to half:
+
+```css
+.pair{display:grid;grid-template-columns:repeat(2,640px);gap:2px}
+/* single-frame variant */
+.overlay{position:relative;width:1280px;height:720px}
+.overlay img{position:absolute;inset:0;width:100%;height:100%;object-fit:cover}
+.overlay .after{clip-path:inset(0 0 0 50%)}
+.overlay .seam{position:absolute;left:50%;top:0;bottom:0;width:2px;background:#fff}
+```
+
+### Watermark / label / border
+
+```css
+.mark{position:absolute;right:20px;bottom:20px;font-size:22px;opacity:.75}
+.framed{border:8px solid #fff;box-shadow:0 8px 30px rgba(0,0,0,.35)}
+```
+
+### Crop, scale, round, filter
+
+Cropping and scaling are `object-fit` on a sized box; there is no separate crop
+tool.
+
+```css
+.crop{width:512px;height:512px;object-fit:cover;object-position:center}   /* fill + centre-crop */
+.fit {width:512px;height:512px;object-fit:contain;background:#111}        /* letterbox, no crop */
+.round{border-radius:24px}
+.grey{filter:grayscale(1) contrast(1.05)}
+```
+
+## When this is the wrong skill
+
+- **Generating a new image** → the media-generation tools. This skill never
+  creates imagery, it only arranges what exists.
+- **A PDF / Word / PowerPoint deliverable** → the document skill (`doc-gen`,
+  `html2pptx`). Do not build a "poster" here and call it a document.
+- **Xiaohongshu campaign cards** → `talos-xhs-ops` (`render-cards`), which owns
+  the 1080×1440 card format and its QA.
+- **Pixel-level algorithms** — background removal, super-resolution,
+  content-aware fill. CSS cannot do these; they need a model.

package/skills/image-layout/bin/html2img.cjs

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+"use strict";
+
+// apps/admin/data/skills.lib/image-layout/bin-src/html2img.mjs
+var import_promises = require("node:fs/promises");
+var import_node_path2 = require("node:path");
+
+// packages/core/dist/document/html-local-assets.js
+var import_node_fs = require("node:fs");
+var import_node_path = require("node:path");
+var import_node_url = require("node:url");
+var IMG_SRC = /(<img\b[^>]*?\bsrc\s*=\s*)(?:"([^"]*)"|'([^']*)'|([^\s>]+))/gi;
+var CSS_URL = /(url\(\s*)(?:"([^"]*)"|'([^']*)'|([^)\s]+))(\s*\))/gi;
+function isNonLocal(ref) {
+  return ref.startsWith("//") || /^[a-z][a-z0-9+.-]*:/i.test(ref) && !ref.toLowerCase().startsWith("file:");
+}
+function resolveLocalAssets(html, baseDir) {
+  const found = /* @__PURE__ */ new Set();
+  const rewrite = (ref) => {
+    const url = ref === void 0 ? void 0 : localFileUrl(ref.trim(), baseDir);
+    if (url)
+      found.add(url);
+    return url;
+  };
+  const withCss = html.replace(CSS_URL, (match, prefix, dq, sq, bare, suffix) => {
+    const url = rewrite(dq ?? sq ?? bare);
+    return url ? `${prefix}"${url}"${suffix}` : match;
+  });
+  const rewritten = withCss.replace(IMG_SRC, (match, prefix, dq, sq, bare) => {
+    const url = rewrite(dq ?? sq ?? bare);
+    return url ? `${prefix}"${url}"` : match;
+  });
+  return { html: rewritten, assetFileUrls: [...found] };
+}
+function localFileUrl(ref, baseDir) {
+  if (!ref)
+    return void 0;
+  let path;
+  if (ref.toLowerCase().startsWith("file:")) {
+    try {
+      path = (0, import_node_url.fileURLToPath)(ref);
+    } catch {
+      return void 0;
+    }
+  } else if (isNonLocal(ref)) {
+    return void 0;
+  } else {
+    const bare = ref.split(/[?#]/)[0];
+    if (!bare)
+      return void 0;
+    path = (0, import_node_path.isAbsolute)(bare) ? bare : (0, import_node_path.resolve)(baseDir, bare);
+  }
+  return (0, import_node_fs.existsSync)(path) ? (0, import_node_url.pathToFileURL)(path).href : void 0;
+}
+
+// apps/admin/data/skills.lib/image-layout/bin-src/html2img.mjs
+function die(msg, code = 1) {
+  process.stderr.write(`html2img: ${msg}
+`);
+  process.exit(code);
+}
+function intArg(flag, fallback) {
+  const i = process.argv.indexOf(flag);
+  if (i < 0) return fallback;
+  const value = Number(process.argv[i + 1]);
+  if (!Number.isInteger(value)) die(`${flag} needs an integer`, 64);
+  return value;
+}
+async function main() {
+  const input = process.argv[2];
+  const output = process.argv[3];
+  if (!input || !output || input.startsWith("--") || output.startsWith("--")) {
+    die("usage: html2img <in.html> <out.png> [--width N] [--max-height N]", 64);
+  }
+  const width = intArg("--width", 1280);
+  const maxHeight = intArg("--max-height", void 0);
+  const url = process.env.TALOS_PDF_URL;
+  if (!url) {
+    die("rendering needs the Talos app's Chromium service (TALOS_PDF_URL is not set). Run inside the Talos app.", 69);
+  }
+  let source;
+  try {
+    source = await (0, import_promises.readFile)(input, "utf8");
+  } catch (e) {
+    die(`cannot read ${input}: ${e.message}`, 66);
+  }
+  const { html, assetFileUrls } = resolveLocalAssets(source, (0, import_node_path2.dirname)((0, import_node_path2.resolve)(input)));
+  let res;
+  try {
+    res = await fetch(url.replace(/\/pdf$/, "/img"), {
+      method: "POST",
+      headers: {
+        "content-type": "application/json",
+        ...process.env.TALOS_PDF_TOKEN ? { authorization: `Bearer ${process.env.TALOS_PDF_TOKEN}` } : {}
+      },
+      body: JSON.stringify({ html, width, ...maxHeight === void 0 ? {} : { maxHeight }, assetFileUrls })
+    });
+  } catch (e) {
+    die(`render request failed: ${e.message}`, 69);
+  }
+  const text = await res.text();
+  if (!res.ok) {
+    let detail = text;
+    try {
+      detail = JSON.parse(text).error ?? text;
+    } catch {
+    }
+    die(`render failed (${res.status}): ${detail}`);
+  }
+  let image;
+  try {
+    image = JSON.parse(text).image;
+  } catch {
+    die("render returned malformed JSON");
+  }
+  if (typeof image !== "string" || !image) die("render returned no image");
+  const dest = (0, import_node_path2.resolve)(output);
+  await (0, import_promises.writeFile)(dest, Buffer.from(image, "base64"));
+  process.stdout.write(`${JSON.stringify({ path: dest, width, assets: assetFileUrls.length })}
+`);
+}
+main().catch((e) => die(e?.message ?? String(e)));