@floless/app 0.21.0 → 0.22.1

package/dist/floless-server.cjs

@@ -52729,7 +52729,7 @@ function appVersion() {
   return resolveVersion({
     isSea: isSea2(),
     sqVersionXml: readSqVersionXml(),
-    define: true ? "0.21.0" : void 0,
+    define: true ? "0.22.1" : void 0,
     pkgVersion: readPkgVersion()
   });
 }
@@ -52739,7 +52739,7 @@ function resolveChannel(s) {
   return "dev";
 }
 function appChannel() {
-  return resolveChannel({ isSea: isSea2(), define: true ? "0.21.0" : void 0 });
+  return resolveChannel({ isSea: isSea2(), define: true ? "0.22.1" : void 0 });
 }
 
 // oauth-presets.ts
@@ -53248,11 +53248,12 @@ var flolessRoot = ROOT2;
 var SnapshotError = class extends Error {
 };
 var MAX_SNAPSHOTS = 8;
-var MAX_BYTES2 = 10 * 1024 * 1024;
+var MAX_BYTES2 = 25 * 1024 * 1024;
 function sniffExt(buf) {
   if (buf.length >= 8 && buf[0] === 137 && buf[1] === 80 && buf[2] === 78 && buf[3] === 71) return "png";
   if (buf.length >= 3 && buf[0] === 255 && buf[1] === 216 && buf[2] === 255) return "jpg";
   if (buf.length >= 12 && buf.toString("ascii", 0, 4) === "RIFF" && buf.toString("ascii", 8, 12) === "WEBP") return "webp";
+  if (buf.length >= 5 && buf[0] === 37 && buf[1] === 80 && buf[2] === 68 && buf[3] === 70 && buf[4] === 45) return "pdf";
   return null;
 }
 function decodeSnapshots(inputs) {
@@ -53261,11 +53262,12 @@ function decodeSnapshots(inputs) {
   return inputs.map((s) => {
     const m = /^data:([\w/+.-]+);base64,(.*)$/s.exec(s.dataUrl || "");
     if (!m) throw new SnapshotError("snapshot must be a base64 data URL");
+    if ((m[2]?.length ?? 0) * 0.75 > MAX_BYTES2) throw new SnapshotError("snapshot too large (max 25 MB)");
     const buf = Buffer.from(m[2] ?? "", "base64");
     if (buf.length === 0) throw new SnapshotError("empty snapshot");
-    if (buf.length > MAX_BYTES2) throw new SnapshotError("snapshot too large (max 10 MB)");
+    if (buf.length > MAX_BYTES2) throw new SnapshotError("snapshot too large (max 25 MB)");
     const ext = sniffExt(buf);
-    if (!ext) throw new SnapshotError("snapshot must be PNG, JPEG, or WebP");
+    if (!ext) throw new SnapshotError("snapshot must be PNG, JPEG, WebP, or PDF");
     return { buf, ext };
   });
 }
@@ -55297,6 +55299,8 @@ var PRODUCT_SKILLS = [
   //  file a diagnosed bug/idea/question to the private log via the floless.io relay
   "floless-app-routines",
   //      author event-driven ("on trigger") routines
+  "floless-app-steel-from-drawings",
+  // read a steel drawing into an interactive 3D model (bake the viewer-3d scene)
   "floless-app-ui",
   //            compose Custom Panels (~/.floless/ui/extensions.json) for the Dashboard
   "floless-app-workflows"
@@ -57242,7 +57246,7 @@ async function startServer() {
     }
   });
   await app.register(import_static.default, { root: WEB_ROOT, prefix: "/" });
-  const MIN_AWARE = "0.68.0";
+  const MIN_AWARE = "0.69.0";
   const isWin3 = process.platform === "win32";
   const has = (cmd) => {
     try {
@@ -57954,7 +57958,7 @@ async function startServer() {
     const p = Number.isInteger(n) ? snapshotPathFor(req.params.id, n) : null;
     if (!p || !(0, import_node_fs23.existsSync)(p)) return reply.status(404).send({ ok: false, error: "snapshot not found" });
     const ext = p.split(".").pop().toLowerCase();
-    reply.header("Content-Type", ext === "png" ? "image/png" : ext === "webp" ? "image/webp" : "image/jpeg");
+    reply.header("Content-Type", ext === "png" ? "image/png" : ext === "webp" ? "image/webp" : ext === "pdf" ? "application/pdf" : "image/jpeg");
     reply.header("Cache-Control", "no-store");
     return (0, import_node_fs23.readFileSync)(p);
   });

package/dist/skills/floless-app-steel-from-drawings/SKILL.md

@@ -0,0 +1,109 @@
+---
+name: floless-app-steel-from-drawings
+description: This skill should be used to turn a structural steel drawing into an interactive 3D model in floless.app — the "Steel from Drawings" reader. Triggers on a pending floless `rebake` request for the `steel-from-drawings` app (queued from its "Re-read & re-bake ▸" button), or asks like "read this framing plan into 3D", "turn this steel drawing into a model", "bake my drawing into steel-from-drawings". It teaches the host AI to READ a steel drawing (PDF/image) with its own vision, extract a schematic 3D scene (grids, members, sizes, takeoff) in the viewer-3d scene schema, bake it INLINE into the app's `view` node, recompile, and ask the user to approve — all at COMPOSE time (no model in the run path, no API key). Also bakes the same scene into the `steel-to-ifc` companion so the model exports to a universal IFC file (open in Tekla, SDS2, Revit, Navisworks). Triggers also on "export this to IFC", "bake to Tekla/SDS2/Revit".
+metadata:
+  version: 0.1.0
+---
+
+# Steel from Drawings — read a steel drawing into an interactive 3D model
+
+## What this is
+
+`steel-from-drawings` is a FloLess app that renders an interactive, **licence-free 3D model** of a
+steel frame (the `viewer-3d` agent) from a scene that **you, the terminal AI, bake from a drawing**.
+The drawing is read **at compose time** with your own vision — there is **no model in the run path
+and no AI API key**: the brain is you, in the terminal (the FloLess thin-UI contract). This is the
+**bake** strategy (`floless-app-rebake` is the generic version; this skill is the steel-specific one,
+and **for `steel-from-drawings` it supersedes the generic re-bake** — you bake the scene INLINE into
+the `.flo`'s `view` node, not into `config.yaml`).
+
+**Bake-out companion (`steel-to-ifc`).** A sibling app writes the SAME scene to a universal **IFC**
+file (IfcColumn/IfcBeam on the real grid) — open it in Tekla, SDS2, Revit or Navisworks; no Tekla
+needed to export. When you bake a scene, bake the *identical* scene into `steel-to-ifc` too (loop
+step 6) so the IFC matches the 3D the user confirmed. The whole loop: **read the drawing → see it in
+3D (`steel-from-drawings`) → bake it out to IFC (`steel-to-ifc`) → finish in your detailing tool.**
+
+> **Pasted a request?** If the user pastes a message beginning with a `[floless-request type=rebake
+> id=…]` marker, that's a request copied from the FloLess Dashboard — resolve it via
+> `GET /api/requests` (match the id), don't run the pasted line verbatim, and `DELETE` it when done.
+
+## The loop
+
+1. **Find the drawing.** From a `rebake` request: `GET http://localhost:<port>/api/requests` → the
+   entry with `type:"rebake"` and `appId:"steel-from-drawings"` carries `snapshots: ["<abs path>"]`.
+   (Or the user just attaches/points at a drawing in prose — same procedure, skip the lookup.)
+2. **Read the drawing with your own vision.** Open the file (PDF or image) and READ it. If it's a
+   large multi-sheet PDF, focus on one framing plan / GA sheet (say which). This is the compose-time
+   extraction — your vision is the reader, not any API.
+3. **Extract a schematic 3D scene** in the schema below (§ Scene schema), following § Reading a steel
+   drawing. Aim for a complete, plausible stick model — the user confirms/nudges it in 3D.
+4. **Bake it INLINE into the app.** Replace the entire `scene:` mapping under the `view` node's
+   `config:` in the app's `.flo` with your extracted scene — in BOTH the installed copy
+   `~/.aware/apps/steel-from-drawings/steel-from-drawings.flo` AND the editable
+   `demos/steel-from-drawings/steel-from-drawings.flo` if present. Change ONLY the `scene:` block;
+   leave `inputs`, `requires`, the node id/agent/command, and everything else identical.
+5. **Recompile.** `aware app compile ~/.aware/apps/steel-from-drawings` → rewrites the `.lock`. The
+   source-hash changes, so FloLess's Run gate disarms until the user approves. Copy the fresh `.lock`
+   to `demos/steel-from-drawings/` if you keep the editable copy in sync.
+6. **Bake the SAME scene into `steel-to-ifc` (the IFC bake-out), if it's installed.** Check
+   `~/.aware/apps/steel-to-ifc/`. If present, replace the `scene:` mapping under that app's `bake-ifc`
+   node `config.args` with the IDENTICAL scene (the installed copy and `demos/steel-to-ifc/` if
+   present), then `aware app compile ~/.aware/apps/steel-to-ifc`. This keeps the exported IFC matching
+   the 3D the user confirmed. (`steel-to-ifc` writes a real IFC file — IfcColumn/IfcBeam on the grid —
+   openable in Tekla, SDS2, Revit or Navisworks; it never touches a Tekla model, so no Tekla needed.)
+7. **Hand the approval to the user.** Tell them what you read (e.g. "read 6 columns + 8 beams on grids
+   A–C / 1–2, heights assumed 4.5 m — review in Inspect → Code, then Compile/Approve, then ▶ Run to
+   see the 3D; run **steel-to-ifc** to export the IFC"). The human eyeballing the read in 3D **is the
+   safety gate**. Never auto-run.
+8. **Clear the request.** `DELETE http://localhost:<port>/api/requests/<id>` once done (if from one).
+
+## Scene schema (the bake target — exactly what `viewer-3d` renders)
+
+```yaml
+scene:
+  meta: { name: "<sheet title / drawing no.>", units: mm, up: z }
+  groups:                       # one per group you use; drives legend + colour
+    - { key: column, label: Columns, color: "#60a5fa" }
+    - { key: beam,   label: Beams,   color: "#94a3b8" }
+    # rafter #38bdf8, brace #818cf8 — add others as needed
+  elements:                     # one per member, kind: box (a from→to bar)
+    - { id: COL-A1, group: column, kind: box, from: [x,y,z], to: [x,y,z],
+        section: { w: 150, d: 150 }, meta: { profile: "HSS6x6x3/8", mark: "C1", grid: "A-1" } }
+  grids:                        # grid labels placed just outside the framing
+    - { label: A, at: [x,y,0] }
+  panels:                       # generic side tables; build a Takeoff
+    - title: Takeoff
+      note: "<assumptions, e.g. heights assumed — plan view, H=4.5 m>"
+      columns: [Section, "No.", Length]
+      rows: [["HSS6x6x3/8", 6, "27.0 m"]]
+```
+
+`from`/`to` are `[x,y,z]` in mm. `meta` is free-form (shown in the click-to-inspect panel) — put
+`profile`, `mark`, `grid` there. `section.w`/`d` are visual thickness only.
+
+## Reading a steel drawing (the method)
+
+1. **Grid.** Find the grid (A,B,C… one way, 1,2,3… the other, plus half-grids). Read the dimension
+   strings to place grids in mm; if a spacing is unreadable, assume a regular ~6000 mm bay and say so.
+2. **Sheet type & heights.** A PLAN view (top-down) shows no heights — pick one eave/storey height H
+   (a level/height note if present, else ~4500 mm) and note it; columns run z:0→H, beams/rafters sit
+   at z:H. An ELEVATION/SECTION gives real heights — read them.
+3. **Members.** One `elements` entry per member, size label exactly as drawn. Columns → `column`,
+   `from:[gx,gy,0] to:[gx,gy,H]`. Beams/rafters → `beam`/`rafter`, along the grid at z:H. Braces →
+   `brace`, the diagonal. Put the size in `meta.profile`, the mark in `meta.mark`, the grid ref in
+   `meta.grid`; approximate `section.w`/`d` from the profile (W12≈300×310, HSS6x6≈150×150, L≈90×90).
+4. **Takeoff.** One row per distinct profile (count + total length in m). Assumptions in the note.
+5. **meta.name** = the sheet title / drawing number. Never invent grids or members the drawing does
+   not show; if a sheet has no readable steel framing, bake an empty `elements` with a note saying so.
+
+## Guardrails
+
+- **Compose-time only.** The drawing is read HERE, by you, then baked. Never add a runtime node that
+  reads the drawing — `aware app validate` rejects it and it breaks determinism.
+- **Scene, not logic.** Re-bake only the `view.scene` block. A different output (new columns, a
+  schedule) is a workflow change — use `floless-app-workflows`, not this.
+- **Schematic + honest.** ~90% is the goal; the user tidies the last 10% in 3D. State your
+  assumptions (heights, assumed bays) in the takeoff note. Don't fabricate sizes the drawing lacks.
+- **Thin-UI contract.** The browser only recorded intent + the drawing; the brain is you, in the
+  terminal. The UI never reads the drawing and never bakes.
+- **Resolve the port** from the running floless.app the same way the other floless-app skills do.

package/dist/web/app.css

@@ -1125,9 +1125,17 @@
     overflow-y: auto;
     display: grid;
     grid-template-columns: 1fr 1fr;
+    /* align-items:start so a collapsed card isn't stretched to match an
+       expanded sibling in the same row (the accordion-in-grid pattern). */
+    align-items: start;
     gap: 6px;
     padding-right: 4px;
   }
+  /* One grid cell per agent: holds the card header + its command list, so the
+     commands nest directly under the picked card (see renderLibrary). */
+  .lib-card { min-width: 0; }
+  .lib-card.expanded .lib-item { border-color: var(--accent-dim); }
+  .lib-card.expanded .lib-fav { transform: rotate(180deg); }
   .lib-item {
     background: var(--surface-2);
     border: 1px solid var(--border-strong);
@@ -1162,6 +1170,7 @@
     border-radius: 3px;
     flex-shrink: 0;
     line-height: 1;
+    transition: transform 0.15s ease, color 0.15s, border-color 0.15s;
   }
   .lib-item .lib-fav.faved { color: var(--star); border-color: var(--star); }
 
@@ -2476,6 +2485,7 @@ body {
   .req-thumbs { display: flex; flex-wrap: wrap; gap: 5px; margin-top: 6px; }
   .req-thumb { width: 46px; height: 46px; padding: 0; border: 1px solid var(--border-strong); border-radius: 4px; background: var(--bg); overflow: hidden; cursor: pointer; flex-shrink: 0; transition: border-color 0.15s; }
   .req-thumb img { width: 100%; height: 100%; object-fit: cover; display: block; }
+  .req-thumb-pdf { display: grid; place-items: center; width: 100%; height: 100%; font-size: 11px; font-weight: 700; letter-spacing: 0.04em; color: var(--text-dim); }
   .req-thumb:hover { border-color: var(--accent-dim); }
 
   /* ============================================================================

package/dist/web/aware.js

@@ -980,8 +980,8 @@
     const name = app.rebakeInput;
     const res = await formModal({
       title: `Re-read & re-bake · ${app.displayName}`,
-      sub: 'Swap the source drawing. Your terminal AI will re-read it, re-bake the values into config, then ask you to approve.',
-      fields: [{ name, label: `${name} — new source drawing`, type: 'file', accept: ['png', 'jpg', 'webp'] }],
+      sub: 'Attach the new drawing (PDF or image). Your terminal AI re-reads it and updates this workflow, then asks you to approve — nothing changes until you do.',
+      fields: [{ name, label: `${name} — new source drawing`, type: 'file', accept: ['pdf', 'png', 'jpg', 'webp'] }],
       okLabel: 'Queue re-bake',
     });
     if (!res) return;
@@ -995,8 +995,8 @@
       });
       const out = await r.json().catch(() => ({ ok: false, error: `re-bake failed (${r.status})` }));
       if (!out || !out.ok) { showToast((out && out.error) || 'could not queue re-bake', 'err'); return; }
-      showToast('Queued — your terminal AI will re-read & re-bake, then ask you to approve.', 'ok');
-      appendNarration(`<strong>Re-bake queued</strong> for <strong>${escapeHtml(name)}</strong>. Your terminal AI will re-read the drawing, re-bake the config literals, and ask you to approve the new lock.`);
+      showToast('Queued — your terminal AI will re-read it and update this workflow, then ask you to approve.', 'ok');
+      appendNarration(`<strong>Re-bake queued</strong> for <strong>${escapeHtml(name)}</strong>. Your terminal AI will re-read the drawing, update this workflow, and ask you to approve the new lock.`);
     } catch { showToast('could not queue re-bake', 'err'); }
   }
 
@@ -1654,6 +1654,8 @@
       $body.onpaste = (e) => {
         const items = Array.from((e.clipboardData && e.clipboardData.items) || []);
         const imgs = items.filter((it) => it.kind === 'file' && it.type.startsWith('image/'));
+        // The single-file field also accepts PDFs (steel drawings) — paste, not just click.
+        const fileItems = items.filter((it) => it.kind === 'file' && (it.type.startsWith('image/') || it.type === 'application/pdf'));
         const box = $body.querySelector('.fm-images');
         if (box) {
           if (!imgs.length) return;
@@ -1673,10 +1675,10 @@
           return;
         }
         const fileBox = $body.querySelector('.fm-file');
-        if (!fileBox || !imgs.length) return;
+        if (!fileBox || !fileItems.length) return;
         e.preventDefault();
         const entry = fileStates.get(fileBox.dataset.fmFileBox);
-        const file = imgs[0].getAsFile();
+        const file = fileItems[0].getAsFile();
         if (entry && file) entry.setFile(file);
       };
       const collect = () => {
@@ -3622,7 +3624,7 @@
           <div class="req-info">
             <div class="req-head"><span class="${badgeCls}">${label}</span> ${r.appId ? `<code>${escapeHtml(r.appId)}</code>` : ''}${target}${time}</div>
             <div class="req-instruction">${escapeHtml(instructionFor(r))}</div>
-            ${r.snapshots && r.snapshots.length ? `<div class="req-thumbs">${r.snapshots.map((_, i) => `<button type="button" class="req-thumb" data-id="${escapeAttr(r.id)}" data-n="${i}" aria-label="View screenshot ${i + 1}"><img src="/api/requests/${encodeURIComponent(r.id)}/snapshot/${i}" alt=""></button>`).join('')}</div>` : ''}
+            ${r.snapshots && r.snapshots.length ? `<div class="req-thumbs">${r.snapshots.map((sp, i) => { const pdf = /\.pdf$/i.test(String(sp)); return `<button type="button" class="req-thumb" data-id="${escapeAttr(r.id)}" data-n="${i}" aria-label="View ${pdf ? 'PDF' : 'screenshot'} ${i + 1}">${pdf ? '<span class="req-thumb-pdf">PDF</span>' : `<img src="/api/requests/${encodeURIComponent(r.id)}/snapshot/${i}" alt="">`}</button>`; }).join('')}</div>` : ''}
           </div>
           <div class="req-actions">
             <button class="req-copy" data-id="${escapeAttr(r.id)}" data-tip="Copy this instruction">⧉</button>
@@ -3679,15 +3681,20 @@
   renderLibrary = function renderLibraryReal() {
     const q = ($libSearch.value || '').toLowerCase().trim();
     const items = agentCatalog.filter((a) => !q || a.id.toLowerCase().includes(q) || (a.kind || '').toLowerCase().includes(q));
+    // Each agent is ONE grid cell: the card header + its (lazy) command list live
+    // in the same `.lib-card`, so expanding nests the commands directly under the
+    // picked card instead of scattering them into a neighbouring grid slot.
     $libList.innerHTML = items.map((a) => `
-      <div class="lib-item" data-agent="${escapeAttr(a.id)}">
-        <div class="info">
-          <div class="name">${escapeHtml(a.id)} <span style="color:var(--text-dim);font-weight:400">v${escapeHtml(String(a.version))}</span></div>
-          <div class="meta">${escapeHtml(a.kind || 'agent')} · ${a.commands} command${a.commands === 1 ? '' : 's'} · ${a.skills} skill${a.skills === 1 ? '' : 's'}</div>
+      <div class="lib-card" data-agent="${escapeAttr(a.id)}">
+        <div class="lib-item">
+          <div class="info">
+            <div class="name">${escapeHtml(a.id)} <span style="color:var(--text-dim);font-weight:400">v${escapeHtml(String(a.version))}</span></div>
+            <div class="meta">${escapeHtml(a.kind || 'agent')} · ${a.commands} command${a.commands === 1 ? '' : 's'} · ${a.skills} skill${a.skills === 1 ? '' : 's'}</div>
+          </div>
+          <button class="lib-fav" data-expand="${escapeAttr(a.id)}" data-tip="Show commands">⌄</button>
         </div>
-        <button class="lib-fav" data-expand="${escapeAttr(a.id)}" data-tip="Show commands">⌄</button>
+        <div class="lib-commands" id="cmds-${escapeAttr(a.id)}" hidden></div>
       </div>
-      <div class="lib-commands" id="cmds-${escapeAttr(a.id)}" hidden></div>
     `).join('') || '<div class="empty-state">No agents match.</div>';
     $libList.querySelectorAll('[data-expand]').forEach((btn) => {
       btn.onclick = () => expandAgent(btn.dataset.expand);
@@ -3697,8 +3704,10 @@
   async function expandAgent(id) {
     const box = document.getElementById(`cmds-${id}`);
     if (!box) return;
-    if (!box.hidden) { box.hidden = true; return; }
+    const card = box.closest('.lib-card');
+    if (!box.hidden) { box.hidden = true; if (card) card.classList.remove('expanded'); return; }
     box.hidden = false;
+    if (card) card.classList.add('expanded');
     box.innerHTML = '<div class="cmd-desc">loading…</div>';
     try {
       const { agent } = await api(`/api/agent/${encodeURIComponent(id)}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@floless/app",
-  "version": "0.21.0",
+  "version": "0.22.1",
   "type": "module",
   "description": "Thin localhost host for floless.app — serves web/ and shells the aware CLI. No engine, no LLM.",
   "bin": {