@bendyline/gezel-cli 1.2.13 → 1.2.14

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.
@@ -3,8 +3,8 @@
3
3
  // src/handboek-export.ts
4
4
  import { existsSync as existsSync2 } from "fs";
5
5
  import { cp, mkdir as mkdir4, writeFile as writeFile4 } from "fs/promises";
6
- import { join as join5, resolve as resolve2 } from "path";
7
- import { SCORECARD_DATA_ATTRS as SCORECARD_DATA_ATTRS3 } from "@bendyline/gezel";
6
+ import { dirname as dirname3, join as join5, resolve as resolve2 } from "path";
7
+ import { SCORECARD_DATA_ATTRS as SCORECARD_DATA_ATTRS3, isGezelDeepLink } from "@bendyline/gezel";
8
8
  import { CatalogService } from "@bendyline/gezel-catalog";
9
9
  import {
10
10
  OG_CARD_HEIGHT,
@@ -104,6 +104,32 @@ async function writePageDemo(directory, files, config, shared) {
104
104
  }
105
105
  }
106
106
 
107
+ // src/site-open-in-gezel.ts
108
+ import { gezelDeepLinkUrl } from "@bendyline/gezel";
109
+ var OPEN_IN_GEZEL_ATTR = "data-gezel-open";
110
+ function openInGezelHtml(opts) {
111
+ return `<span class="open-in-gezel" ${OPEN_IN_GEZEL_ATTR} hidden><a class="${opts.buttonClass}" href="${gezelDeepLinkUrl(opts.link)}">${opts.label}</a><span class="${opts.noteClass}" hidden>Nothing opened? Opening from this site needs the latest Gezel. <a href="${opts.downloadHref}">Get Gezel</a></span></span>`;
112
+ }
113
+ var OPEN_IN_GEZEL_JS = `(function () {
114
+ if (/Android|iPhone|iPad|iPod|Mobile/i.test(navigator.userAgent)) return;
115
+ var wrappers = document.querySelectorAll('[${OPEN_IN_GEZEL_ATTR}]');
116
+ Array.prototype.forEach.call(wrappers, function (wrapper) {
117
+ var link = wrapper.querySelector('a');
118
+ var note = wrapper.querySelector('span');
119
+ if (!link || !note) return;
120
+ wrapper.hidden = false;
121
+ link.addEventListener('click', function () {
122
+ var timer = setTimeout(function () {
123
+ if (document.hasFocus() && document.visibilityState === 'visible') note.hidden = false;
124
+ }, 2500);
125
+ var left = function () { clearTimeout(timer); };
126
+ window.addEventListener('blur', left, { once: true });
127
+ document.addEventListener('visibilitychange', left, { once: true });
128
+ });
129
+ });
130
+ })();
131
+ `;
132
+
107
133
  // src/apps-site.ts
108
134
  var CATEGORIES = [
109
135
  ["home", "Home & Family"],
@@ -235,7 +261,7 @@ function masthead() {
235
261
  <a href="/apps/" aria-current="page">Apps</a>
236
262
  <a href="/docs/">Docs</a>
237
263
  <a href="/docs/model-scorecard/">Model scorecard</a>
238
- <a href="/platform/">For developers</a>
264
+ <a href="/platform/">Platform</a>
239
265
  <a href="https://github.com/bendyline/gezel">GitHub</a>
240
266
  </nav>
241
267
  </header>`;
@@ -243,7 +269,7 @@ function masthead() {
243
269
  function footer(ctx) {
244
270
  return `<footer>
245
271
  <p>\xA9 2026 Bendyline \xB7 Free and open source under the MIT license</p>
246
- <p><a href="https://github.com/bendyline/gezel">GitHub</a><span class="sep" aria-hidden="true">\xB7</span><a href="/platform/">For developers</a><span class="sep" aria-hidden="true">\xB7</span><a href="${esc(ctx.docsBase)}craftbooks-index/">Craftbooks</a><span class="sep" aria-hidden="true">\xB7</span><a href="https://github.com/bendyline/gilde">Contribute an app</a></p>
272
+ <p><a href="https://github.com/bendyline/gezel">Star on GitHub</a><span class="sep" aria-hidden="true">\xB7</span><a href="/platform/">Platform</a><span class="sep" aria-hidden="true">\xB7</span><a href="${esc(ctx.docsBase)}craftbooks-index/">Craftbooks</a><span class="sep" aria-hidden="true">\xB7</span><a href="https://github.com/bendyline/gilde">Contribute an app</a></p>
247
273
  </footer>`;
248
274
  }
249
275
  function mark(app, size, href) {
@@ -381,7 +407,13 @@ ${mark(app, 200, "logo.webp")}
381
407
  <div>
382
408
  <h1>${esc(m.name)}</h1>
383
409
  <p class="lede">${esc(m.description)}</p>
384
- <p class="app-actions"><a class="button" href="/#download">Get Gezel</a><a class="text-link" href="${esc(docs)}project-type/${esc(m.id)}/">Read about it in the docs<span aria-hidden="true"> \u2192</span></a></p>
410
+ <p class="app-actions">${ctx.openInGezel ? `${openInGezelHtml({
411
+ link: { kind: "app", id: m.id },
412
+ label: "Open in Gezel",
413
+ buttonClass: "button",
414
+ noteClass: "open-in-gezel-note",
415
+ downloadHref: "/#download"
416
+ })}<a class="button button-quiet" href="/#download">Get Gezel</a>` : '<a class="button" href="/#download">Get Gezel</a>'}<a class="text-link" href="${esc(docs)}project-type/${esc(m.id)}/">Read about it in the docs<span aria-hidden="true"> \u2192</span></a><a class="text-link" href="/platform/#ai-apps">Make one like this<span aria-hidden="true"> \u2192</span></a></p>
385
417
  </div>
386
418
  </section>
387
419
  ${demo}
@@ -402,7 +434,9 @@ ${more.length ? `<section class="more" aria-labelledby="more"><h2 id="more">More
402
434
  </main>
403
435
  ${footer(ctx)}
404
436
  </div>
405
- </body>
437
+ ${ctx.openInGezel ? `<script>
438
+ ${OPEN_IN_GEZEL_JS}</script>
439
+ ` : ""}</body>
406
440
  </html>
407
441
  `;
408
442
  }
@@ -487,6 +521,11 @@ header.masthead { display: flex; align-items: center; justify-content: space-bet
487
521
  .app-actions { display: flex; flex-wrap: wrap; align-items: center; gap: 12px 24px; margin: 1.2rem 0 0; }
488
522
  .button { display: inline-flex; align-items: center; min-height: 44px; padding: 0 20px; border-radius: 6px; background: var(--action-bg); color: var(--action-ink); font-weight: 600; box-shadow: inset 0 1px 0 rgba(255,255,255,0.2), 0 1px 2px rgba(0,0,0,0.15); }
489
523
  .button:hover { color: var(--action-ink); filter: brightness(1.06); }
524
+ .button-quiet { background: transparent; color: var(--text); box-shadow: inset 0 0 0 2px var(--accent-line); }
525
+ .button-quiet:hover { color: var(--accent); filter: none; box-shadow: inset 0 0 0 2px var(--accent); }
526
+ .open-in-gezel { display: inline-flex; flex-wrap: wrap; align-items: center; gap: 8px 14px; }
527
+ .open-in-gezel[hidden], .open-in-gezel-note[hidden] { display: none; }
528
+ .open-in-gezel-note { flex-basis: 100%; font-size: 0.86rem; color: var(--muted-strong); }
490
529
  .demo { margin: 8px 0 48px; }
491
530
  .demo-head { display: flex; align-items: baseline; justify-content: space-between; gap: 16px; flex-wrap: wrap; }
492
531
  .demo h2, .inside h2, .steps h2, .more h2 { font-size: 1.6rem; margin: 0 0 0.4rem; }
@@ -1413,6 +1452,39 @@ ${DATA_TABLE_LOGIC_JS}
1413
1452
  })();
1414
1453
  `;
1415
1454
 
1455
+ // src/handboek-links.ts
1456
+ var PUBLISHED_HANDBOEK = "https://gezel.com/docs/";
1457
+ var up = (depth) => "../".repeat(depth);
1458
+ function rewriteSiteLinks(markdown, pageId, ids, byStem, hasAsset = () => true, base) {
1459
+ const prefix = base ?? up(pageId.split("/").length);
1460
+ return markdown.replace(/\]\(([^()\s]+)\)/g, (whole, rawTarget) => {
1461
+ if (/^[a-z][a-z0-9+.-]*:/i.test(rawTarget) || rawTarget.startsWith("//") || rawTarget.startsWith("#")) {
1462
+ return whole;
1463
+ }
1464
+ const [path, suffix = ""] = splitLinkSuffix(rawTarget);
1465
+ const candidate = path.replace(/^(\.\.?\/)+/, "");
1466
+ if (candidate.startsWith("assets/")) {
1467
+ return hasAsset(candidate) ? `](${prefix}${candidate}${suffix})` : `](${PUBLISHED_HANDBOEK}${candidate}${suffix})`;
1468
+ }
1469
+ const article = candidate.replace(/\.md$/, "");
1470
+ const target = ids.has(article) ? article : byStem.get(article.split("/").pop() ?? "");
1471
+ if (!target) return whole;
1472
+ return `](${prefix}${target}/${suffix})`;
1473
+ });
1474
+ }
1475
+ function siteLinkIndex(entryIds) {
1476
+ const byStem = /* @__PURE__ */ new Map();
1477
+ for (const id of entryIds) {
1478
+ const stem = id.split("/").pop();
1479
+ if (stem && !byStem.has(stem)) byStem.set(stem, id);
1480
+ }
1481
+ return { ids: new Set(entryIds), byStem };
1482
+ }
1483
+ function splitLinkSuffix(raw) {
1484
+ const idx = raw.search(/[?#]/);
1485
+ return idx === -1 ? [raw, ""] : [raw.slice(0, idx), raw.slice(idx)];
1486
+ }
1487
+
1416
1488
  // src/handboek-og-cards.ts
1417
1489
  import { createHash as createHash3 } from "crypto";
1418
1490
  import { existsSync } from "fs";
@@ -2668,6 +2740,26 @@ th[aria-sort='descending'] .hb-data-table-sort::after { content: ' \u2193'; opac
2668
2740
  }
2669
2741
  .hb-demo-open { font-size: 0.9rem; }
2670
2742
 
2743
+ /* "Run this in Gezel": a gezel:// link under a craftbook's or app's title.
2744
+ Hidden until open-in-gezel.js shows it, on computers only. */
2745
+ .hb-open { margin: 0 0 1.5rem; }
2746
+ .open-in-gezel { display: inline-flex; flex-wrap: wrap; align-items: center; gap: 0.5rem 0.9rem; }
2747
+ .open-in-gezel[hidden], .hb-open-note[hidden] { display: none; }
2748
+ .hb-open-button {
2749
+ display: inline-flex;
2750
+ align-items: center;
2751
+ min-height: 40px;
2752
+ padding: 0 1rem;
2753
+ border-radius: var(--hb-radius-sm);
2754
+ background: var(--hb-accent);
2755
+ color: #fff;
2756
+ font-family: var(--hb-font-ui);
2757
+ font-weight: 600;
2758
+ text-decoration: none;
2759
+ }
2760
+ .hb-open-button:hover { background: var(--hb-accent-hover); color: #fff; }
2761
+ .hb-open-note { flex-basis: 100%; font-size: 0.86rem; color: var(--hb-ink-muted); }
2762
+
2671
2763
  /* Craftbook marks: one under each craftbook's title, and a gallery shelf.
2672
2764
  Marks are transparent cut-outs, so the image's own background is the
2673
2765
  colored paper the app paints behind them, picked by data-ground. Cream
@@ -2784,13 +2876,26 @@ ${groundRules}
2784
2876
  var NAV_INLINE_MAX = 40;
2785
2877
  var SCORECARD_SCRIPT = "scorecard.js";
2786
2878
  var PLAYER_SCRIPT = "squisq-player.js";
2879
+ var OPEN_IN_GEZEL_SCRIPT = "open-in-gezel.js";
2787
2880
  function pageScripts(body) {
2788
2881
  return [
2789
2882
  ...body.includes(SCORECARD_DATA_ATTRS3.root) ? [SCORECARD_SCRIPT] : [],
2883
+ ...body.includes(OPEN_IN_GEZEL_ATTR) ? [OPEN_IN_GEZEL_SCRIPT] : [],
2790
2884
  // Deferred scripts run in order: the player must exist before the mount.
2791
2885
  ...body.includes(DATA_TABLE_ATTR) ? [PLAYER_SCRIPT, DATA_TABLE_SCRIPT] : []
2792
2886
  ];
2793
2887
  }
2888
+ function openInGezelSection(entryId, siteUrl) {
2889
+ const [area, id] = entryId.split("/");
2890
+ const target = area === "craftbook" && id ? { link: { kind: "craftbook", id }, label: "Run this in Gezel" } : area === "project-type" && id ? { link: { kind: "app", id }, label: "Open in Gezel" } : void 0;
2891
+ if (!target || !isGezelDeepLink(target.link)) return void 0;
2892
+ return `<p class="hb-open">${openInGezelHtml({
2893
+ ...target,
2894
+ buttonClass: "hb-open-button",
2895
+ noteClass: "hb-open-note",
2896
+ downloadHref: `${esc2(siteUrl)}#download`
2897
+ })}</p>`;
2898
+ }
2794
2899
  var AREA_BLURBS = {
2795
2900
  conceptual: "What gezel is, who your crew are, and how the pieces fit together.",
2796
2901
  "gezel-roles": "The roles a gezel can take, and what each one is good at.",
@@ -2835,15 +2940,12 @@ async function runHandboekExport(opts) {
2835
2940
  ...areas.flatMap((a) => a.entries),
2836
2941
  ...site.pages.filter((p) => !p.listed && !p.replaces).map((p) => p.entry)
2837
2942
  ];
2838
- const ids = new Set(entries.map((e) => e.id));
2839
- const byStem = /* @__PURE__ */ new Map();
2840
- for (const e of entries) {
2841
- const stem = e.id.split("/").pop();
2842
- if (stem && !byStem.has(stem)) byStem.set(stem, e.id);
2843
- }
2943
+ const { ids, byStem } = siteLinkIndex(entries.map((e) => e.id));
2944
+ const twinBase = normalizeBase(opts.canonicalBase) ?? PUBLISHED_HANDBOEK;
2844
2945
  await mkdir4(join5(out, "assets"), { recursive: true });
2845
2946
  await writeFile4(join5(out, "assets", PLAYER_SCRIPT), PLAYER_BUNDLE, "utf8");
2846
2947
  await writeFile4(join5(out, "assets", SCORECARD_SCRIPT), SCORECARD_FILTER_JS, "utf8");
2948
+ await writeFile4(join5(out, "assets", OPEN_IN_GEZEL_SCRIPT), OPEN_IN_GEZEL_JS, "utf8");
2847
2949
  await writeFile4(join5(out, "assets", DATA_TABLE_SCRIPT), DATA_TABLE_JS, "utf8");
2848
2950
  const skipped = [];
2849
2951
  const warnings = [];
@@ -2859,18 +2961,22 @@ async function runHandboekExport(opts) {
2859
2961
  title: entry.title,
2860
2962
  markdown: sitePage.markdown,
2861
2963
  defaultDuration: void 0
2862
- } : await engine.article(entry.id, { mode: "site" });
2964
+ } : await engine.article(entry.id, { mode: "site", inlineIncludes: true });
2863
2965
  if (!article) {
2864
2966
  skipped.push(entry.id);
2865
2967
  continue;
2866
2968
  }
2867
2969
  const depth = entry.id.split("/").length;
2868
- const markdown = rewriteSiteLinks(
2869
- article.markdown,
2870
- entry.id,
2871
- ids,
2872
- byStem,
2873
- (asset) => existsSync2(join5(contentDir, asset))
2970
+ const hasAsset = (asset) => existsSync2(join5(contentDir, asset));
2971
+ const markdown = rewriteSiteLinks(article.markdown, entry.id, ids, byStem, hasAsset);
2972
+ await mkdir4(dirname3(join5(out, `${entry.id}.md`)), { recursive: true });
2973
+ await writeFile4(
2974
+ join5(out, `${entry.id}.md`),
2975
+ markdownTwin(
2976
+ entry.title,
2977
+ rewriteSiteLinks(article.markdown, entry.id, ids, byStem, hasAsset, twinBase)
2978
+ ),
2979
+ "utf8"
2874
2980
  );
2875
2981
  const parsed = parseMarkdown(markdown);
2876
2982
  const doc = markdownToDoc(parsed, {
@@ -2892,6 +2998,8 @@ ${sitePage.html}`;
2892
2998
  const appsPage = opts.appsOut ? `/apps/${demo.projectTypeId}/` : void 0;
2893
2999
  rendered = insertDemoSection(rendered, demoSectionHtml(demo, entry.title, appsPage));
2894
3000
  }
3001
+ const open = siteUrl && opts.openInGezel ? openInGezelSection(entry.id, siteUrl) : void 0;
3002
+ if (open) rendered = insertAfterTitle(rendered, open);
2895
3003
  if (art) rendered = insertAfterTitle(rendered, craftbookArtHtml(entry.title, art.ground));
2896
3004
  const { html: body, headings } = withHeadingIds(rendered);
2897
3005
  const dir = join5(out, ...entry.id.split("/"));
@@ -2936,7 +3044,7 @@ ${sitePage.html}`;
2936
3044
  await writeFile4(
2937
3045
  join5(dir, "watch.html"),
2938
3046
  generateExternalHtml(doc, {
2939
- playerScriptPath: `${up(depth)}assets/${PLAYER_SCRIPT}`,
3047
+ playerScriptPath: `${up2(depth)}assets/${PLAYER_SCRIPT}`,
2940
3048
  mode: "slideshow",
2941
3049
  title: article.title,
2942
3050
  autoPlay: true,
@@ -2960,6 +3068,11 @@ ${sitePage.html}`;
2960
3068
  }
2961
3069
  await writeFile4(join5(out, "index.html"), landingPage(areas, css, siteUrl, landingSocial), "utf8");
2962
3070
  pages += 1;
3071
+ const written = areas.map((a) => ({
3072
+ ...a,
3073
+ entries: a.entries.filter((e) => !skipped.includes(e.id))
3074
+ }));
3075
+ await writeFile4(join5(out, "llms.txt"), llmsTxt(written, twinBase), "utf8");
2963
3076
  const assetsSrc = join5(contentDir, "assets");
2964
3077
  if (existsSync2(assetsSrc)) {
2965
3078
  await cp(assetsSrc, join5(out, "assets"), { recursive: true });
@@ -2979,7 +3092,8 @@ ${sitePage.html}`;
2979
3092
  const apps = opts.appsOut ? await writeAppsSite(catalog, site, {
2980
3093
  out: resolve2(opts.appsOut),
2981
3094
  docsBase: "/docs/",
2982
- ...canonicalBase ? { siteOrigin: new URL(canonicalBase).origin } : {}
3095
+ ...canonicalBase ? { siteOrigin: new URL(canonicalBase).origin } : {},
3096
+ ...opts.openInGezel ? { openInGezel: true } : {}
2983
3097
  }) : void 0;
2984
3098
  return { out, pages, skipped, warnings, cards, apps };
2985
3099
  }
@@ -2989,29 +3103,34 @@ function normalizeBase(base) {
2989
3103
  if (!trimmed) return void 0;
2990
3104
  return trimmed.endsWith("/") ? trimmed : `${trimmed}/`;
2991
3105
  }
2992
- function rewriteSiteLinks(markdown, pageId, ids, byStem, hasAsset = () => true) {
2993
- const prefix = up(pageId.split("/").length);
2994
- return markdown.replace(/\]\(([^()\s]+)\)/g, (whole, rawTarget) => {
2995
- if (/^[a-z][a-z0-9+.-]*:/i.test(rawTarget) || rawTarget.startsWith("//") || rawTarget.startsWith("#")) {
2996
- return whole;
2997
- }
2998
- const [path, suffix = ""] = splitLinkSuffix(rawTarget);
2999
- const candidate = path.replace(/^(\.\.?\/)+/, "");
3000
- if (candidate.startsWith("assets/")) {
3001
- return hasAsset(candidate) ? `](${prefix}${candidate}${suffix})` : `](${PUBLISHED_HANDBOEK}${candidate}${suffix})`;
3002
- }
3003
- const article = candidate.replace(/\.md$/, "");
3004
- const target = ids.has(article) ? article : byStem.get(article.split("/").pop() ?? "");
3005
- if (!target) return whole;
3006
- return `](${prefix}${target}/${suffix})`;
3007
- });
3106
+ function markdownTwin(title, markdown) {
3107
+ const body = markdown.trimStart();
3108
+ const titled = body.startsWith("# ") ? body : `# ${title}
3109
+
3110
+ ${body}`;
3111
+ return `${titled.trimEnd()}
3112
+ `;
3008
3113
  }
3009
- function splitLinkSuffix(raw) {
3010
- const idx = raw.search(/[?#]/);
3011
- return idx === -1 ? [raw, ""] : [raw.slice(0, idx), raw.slice(idx)];
3114
+ function llmsTxt(areas, base) {
3115
+ const lines = [
3116
+ "# Gezel Handboek",
3117
+ "",
3118
+ "> Gezel is a free, open-source app and platform for running a crew of AI agents on your own computer, with local models or a cloud plan you already have. Every article below is plain markdown.",
3119
+ "",
3120
+ `To build a Gezel app, read [Build a Gezel app: the complete guide](${base}${APP_GUIDE_ID}.md) first. It holds the working loop, the rules, and the four app-building guides in full.`
3121
+ ];
3122
+ for (const area of areas) {
3123
+ lines.push("", `## ${area.title}`, "");
3124
+ for (const entry of area.entries) {
3125
+ const summary = entry.summary ? `: ${entry.summary.replace(/\s+/g, " ").trim()}` : "";
3126
+ lines.push(`- [${entry.title}](${base}${entry.id}.md)${summary}`);
3127
+ }
3128
+ }
3129
+ return `${lines.join("\n")}
3130
+ `;
3012
3131
  }
3013
- var PUBLISHED_HANDBOEK = "https://gezel.com/docs/";
3014
- var up = (depth) => "../".repeat(depth);
3132
+ var APP_GUIDE_ID = "build-a-gezel-app";
3133
+ var up2 = (depth) => "../".repeat(depth);
3015
3134
  var esc2 = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
3016
3135
  function extractBody(page) {
3017
3136
  const match = page.match(/<body[^>]*>([\s\S]*)<\/body>/i);
@@ -3052,10 +3171,10 @@ function resolveCssHref(href, depth) {
3052
3171
  if (/^[a-z][a-z0-9+.-]*:/i.test(href) || href.startsWith("//") || href.startsWith("/")) {
3053
3172
  return href;
3054
3173
  }
3055
- return `${up(depth)}${href}`;
3174
+ return `${up2(depth)}${href}`;
3056
3175
  }
3057
3176
  function cssLinks(css, depth) {
3058
- return [`${up(depth)}assets/handboek.css`, ...css.map((h) => resolveCssHref(h, depth))].map((href) => `<link rel="stylesheet" href="${esc2(href)}">`).join("\n");
3177
+ return [`${up2(depth)}assets/handboek.css`, ...css.map((h) => resolveCssHref(h, depth))].map((href) => `<link rel="stylesheet" href="${esc2(href)}">`).join("\n");
3059
3178
  }
3060
3179
  function socialTags(description, social) {
3061
3180
  const title = social.title;
@@ -3101,12 +3220,12 @@ function masthead2(areas, depth, siteUrl, currentArea) {
3101
3220
  const links = areas.map((a) => {
3102
3221
  const target = areaLanding(a);
3103
3222
  const current = a.area === currentArea ? ' aria-current="true"' : "";
3104
- return `<a${current} href="${up(depth)}${esc2(target)}/">${esc2(a.title)}</a>`;
3223
+ return `<a${current} href="${up2(depth)}${esc2(target)}/">${esc2(a.title)}</a>`;
3105
3224
  }).join("\n");
3106
3225
  const wordmark = siteUrl ? `<a class="hb-wordmark" href="${esc2(siteUrl)}">${WORDMARK}</a>
3107
3226
  ` : "";
3108
3227
  return `<header class="hb-masthead">
3109
- ${wordmark}<a class="hb-brand" href="${up(depth)}">Gezel Handboek</a>
3228
+ ${wordmark}<a class="hb-brand" href="${up2(depth)}">Gezel Handboek</a>
3110
3229
  <nav class="hb-areanav">
3111
3230
  ${links}
3112
3231
  </nav>
@@ -3125,8 +3244,8 @@ function sidebar(areas, entry, depth) {
3125
3244
  const isCurrent = area.area === entry.area;
3126
3245
  const items = isCurrent && area.entries.length <= NAV_INLINE_MAX ? area.entries : isCurrent ? dedupeById([...area.entries.filter((e) => e.id === areaLanding(area)), entry]) : [];
3127
3246
  const list = items.length ? sidebarEntryList(items, entry.id, depth) : "";
3128
- const more = isCurrent && area.entries.length > NAV_INLINE_MAX ? `<p class="hb-more"><a href="${up(depth)}${esc2(areaLanding(area))}/">All ${articleCount(area)} ${esc2(area.title.toLowerCase())}</a></p>` : "";
3129
- const heading = isCurrent ? `<h2 class="hb-current">${esc2(area.title)}</h2>` : `<h2><a href="${up(depth)}${esc2(areaLanding(area))}/">${esc2(area.title)}</a></h2>`;
3247
+ const more = isCurrent && area.entries.length > NAV_INLINE_MAX ? `<p class="hb-more"><a href="${up2(depth)}${esc2(areaLanding(area))}/">All ${articleCount(area)} ${esc2(area.title.toLowerCase())}</a></p>` : "";
3248
+ const heading = isCurrent ? `<h2 class="hb-current">${esc2(area.title)}</h2>` : `<h2><a href="${up2(depth)}${esc2(areaLanding(area))}/">${esc2(area.title)}</a></h2>`;
3130
3249
  return `<section>
3131
3250
  ${heading}
3132
3251
  ${list}
@@ -3171,7 +3290,7 @@ ${items.join("\n")}
3171
3290
  }
3172
3291
  function sidebarEntryLink(entry, currentId, depth) {
3173
3292
  const current = entry.id === currentId ? ' class="hb-current" aria-current="page"' : "";
3174
- return `<li><a${current} href="${up(depth)}${esc2(entry.id)}/">${esc2(entry.title)}</a></li>`;
3293
+ return `<li><a${current} href="${up2(depth)}${esc2(entry.id)}/">${esc2(entry.title)}</a></li>`;
3175
3294
  }
3176
3295
  function dedupeById(list) {
3177
3296
  const seen = /* @__PURE__ */ new Set();
@@ -3193,7 +3312,7 @@ function articlePage(args) {
3193
3312
  const { entry, body, headings, areas, depth, css, siteUrl, social, scripts } = args;
3194
3313
  const area = areas.find((a) => a.area === entry.area);
3195
3314
  const aside = onThisPage(headings);
3196
- const scriptTags = scripts.map((name) => `<script defer src="${up(depth)}assets/${esc2(name)}"></script>`).join("\n");
3315
+ const scriptTags = scripts.map((name) => `<script defer src="${up2(depth)}assets/${esc2(name)}"></script>`).join("\n");
3197
3316
  return `${head2(`${entry.title} \u2014 Gezel Handboek`, css, depth, entry.summary, social)}
3198
3317
  <body class="hb hb-article-page">
3199
3318
  ${masthead2(areas, depth, siteUrl, entry.area)}
@@ -3201,12 +3320,12 @@ ${masthead2(areas, depth, siteUrl, entry.area)}
3201
3320
  ${sidebar(areas, entry, depth)}
3202
3321
  <main class="hb-main">
3203
3322
  <nav class="hb-breadcrumb" aria-label="Breadcrumb">
3204
- <a href="${up(depth)}">Handboek</a>${area ? ` <span>/</span> <a href="${up(depth)}${esc2(areaLanding(area))}/">${esc2(area.title)}</a>` : ""}
3323
+ <a href="${up2(depth)}">Handboek</a>${area ? ` <span>/</span> <a href="${up2(depth)}${esc2(areaLanding(area))}/">${esc2(area.title)}</a>` : ""}
3205
3324
  </nav>
3206
3325
  <article class="hb-article">
3207
3326
  ${body}
3208
3327
  </article>
3209
- <p class="hb-watch"><a href="watch.html">Watch this article as a slideshow</a></p>
3328
+ <p class="hb-watch"><a href="watch.html">Watch this article as a slideshow</a> \xB7 <a href="../${esc2(entry.id.split("/").pop() ?? entry.id)}.md">Read it as markdown, for AI agents</a></p>
3210
3329
  </main>
3211
3330
  ${aside}
3212
3331
  </div>
@@ -3217,7 +3336,7 @@ ${scriptTags}
3217
3336
  }
3218
3337
  function footer2(depth) {
3219
3338
  return `<footer class="hb-footer">
3220
- <p><a href="${up(depth)}">Gezel Handboek</a> \u2014 documentation for gezel, a crew of AI companions that works for you, from your own computer.</p>
3339
+ <p><a href="${up2(depth)}">Gezel Handboek</a> \u2014 documentation for gezel, a crew of AI companions that works for you, from your own computer.</p>
3221
3340
  </footer>`;
3222
3341
  }
3223
3342
  function landingPage(areas, css, siteUrl, social) {
@@ -3266,6 +3385,9 @@ ${footer2(0)}
3266
3385
  }
3267
3386
  export {
3268
3387
  extractBody,
3388
+ llmsTxt,
3389
+ markdownTwin,
3390
+ openInGezelSection,
3269
3391
  pageScripts,
3270
3392
  resolveCssHref,
3271
3393
  rewriteSiteLinks,
package/dist/tui/index.js CHANGED
@@ -2537,6 +2537,25 @@ var NATIVE_TOOLKIT = [
2537
2537
  "whisper-server",
2538
2538
  "llama-server"
2539
2539
  ];
2540
+ function nativeEngineUse(engine) {
2541
+ switch (engine) {
2542
+ case "llama-server":
2543
+ return "runs chat models on this computer";
2544
+ case "uv":
2545
+ return "runs local helpers such as voices and image reading";
2546
+ case "sd-server":
2547
+ return "makes images";
2548
+ case "whisper-server":
2549
+ return "turns speech into text";
2550
+ case "ds4-server":
2551
+ return "runs DeepSeek V4 models";
2552
+ case "duckdb":
2553
+ return "queries spreadsheets and data files";
2554
+ }
2555
+ }
2556
+ function nativeToolkitTitle(missing, provider) {
2557
+ return missing.includes(provider === "mlx" ? "uv" : "llama-server") ? "The engine Gezel needs to run chat models on this computer is not installed yet" : "Some optional Gezel engines are not installed yet";
2558
+ }
2540
2559
  function recoDevice(memory) {
2541
2560
  return {
2542
2561
  platform: memory.platform,
@@ -5052,25 +5071,22 @@ function BootstrapGate(props) {
5052
5071
  ] });
5053
5072
  }
5054
5073
  if (screen.kind === "native-choice") {
5055
- const labels = screen.missing.map(nativeLabel).join(", ");
5056
- return /* @__PURE__ */ jsxs7(BootstrapFrame, { title: "The Gezel native toolkit -- needed to run AI models locally -- is not installed yet", children: [
5074
+ return /* @__PURE__ */ jsxs7(BootstrapFrame, { title: nativeToolkitTitle(screen.missing, screen.context.provider), children: [
5057
5075
  /* @__PURE__ */ jsx6(Text7, { children: `Gezel can install the verified Gezel native toolkit (native-v${screen.context.nativeStatus.release}) for this device.` }),
5058
5076
  /* @__PURE__ */ jsxs7(Text7, { children: [
5059
5077
  "Downloaded from",
5060
5078
  " ",
5061
5079
  /* @__PURE__ */ jsx6(Text7, { bold: true, color: "cyan", children: "https://github.com/bendyline/gezel/releases/" })
5062
5080
  ] }),
5063
- /* @__PURE__ */ jsxs7(Text7, { dimColor: true, children: [
5064
- "Missing: ",
5065
- labels
5066
- ] }),
5081
+ /* @__PURE__ */ jsx6(Text7, { dimColor: true, children: "Not installed:" }),
5082
+ screen.missing.map((engine) => /* @__PURE__ */ jsx6(Text7, { dimColor: true, children: ` - ${nativeLabel(engine)}: ${nativeEngineUse(engine)}` }, engine)),
5067
5083
  /* @__PURE__ */ jsx6(
5068
5084
  BootstrapChoiceList,
5069
5085
  {
5070
5086
  options: [
5071
5087
  {
5072
5088
  label: "Install the Gezel native toolkit",
5073
- hint: "recommended \xB7 engines for chat, images, speech, and local model helpers",
5089
+ hint: `recommended \xB7 ${screen.missing.length === 1 ? "the engine" : `the ${screen.missing.length} engines`} above`,
5074
5090
  value: "install"
5075
5091
  },
5076
5092
  { label: "Not now", hint: "continue to model choices", value: "skip" }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@bendyline/gezel-cli",
3
- "version": "1.2.13",
3
+ "version": "1.2.14",
4
4
  "description": "The gezel command-line tool: chat with your gezels, run craftbooks, and manage local models from the terminal.",
5
5
  "license": "MIT",
6
6
  "keywords": [
@@ -44,15 +44,15 @@
44
44
  "!dist/**/*.map"
45
45
  ],
46
46
  "dependencies": {
47
- "@bendyline/gezel": "1.2.13",
48
- "@bendyline/gezel-app-sdk": "1.1.13",
49
- "@bendyline/gezel-catalog": "1.2.13",
50
- "@bendyline/gezel-client": "1.2.13",
47
+ "@bendyline/gezel": "1.2.14",
48
+ "@bendyline/gezel-app-sdk": "1.1.14",
49
+ "@bendyline/gezel-catalog": "1.2.14",
50
+ "@bendyline/gezel-client": "1.2.14",
51
51
  "@bendyline/gezel-knowledge": "1.2.10",
52
- "@bendyline/gezel-service": "1.2.13",
53
- "@bendyline/squisq": "2.13.10",
54
- "@bendyline/squisq-formats": "2.8.12",
55
- "@bendyline/squisq-react": "2.12.22",
52
+ "@bendyline/gezel-service": "1.2.14",
53
+ "@bendyline/squisq": "2.13.12",
54
+ "@bendyline/squisq-formats": "2.8.14",
55
+ "@bendyline/squisq-react": "2.12.24",
56
56
  "commander": "^15.0.0",
57
57
  "ink": "^7.1.1",
58
58
  "ink-text-input": "^6.0.0",