@construct-space/cli 1.6.2 → 1.6.3

package/dist/index.js

@@ -5354,7 +5354,7 @@ async function scaffold(nameArg, options) {
 // src/commands/build.ts
 init_source();
 import { existsSync as existsSync6, readFileSync as readFileSync4, readdirSync as readdirSync3, renameSync, statSync as statSync3 } from "fs";
-import { join as join6 } from "path";
+import { extname as extname3, join as join6 } from "path";
 import { createHash } from "crypto";
 
 // node_modules/ora/index.js
@@ -8422,6 +8422,71 @@ function extractActionMetadata(actionsPath) {
     return null;
   }
 }
+var ICON_MIME = {
+  ".svg": "image/svg+xml",
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".webp": "image/webp",
+  ".gif": "image/gif",
+  ".ico": "image/x-icon"
+};
+function isInlineableIcon(value) {
+  if (typeof value !== "string" || !value)
+    return false;
+  if (value.startsWith("i-") || value.startsWith("lucide:"))
+    return false;
+  if (value.startsWith("data:"))
+    return false;
+  if (/^https?:\/\//.test(value))
+    return false;
+  return extname3(value).toLowerCase() in ICON_MIME;
+}
+function resolveIconPath(root, ref) {
+  const rel = ref.replace(/^\.?\//, "");
+  for (const candidate of [join6(root, rel), join6(root, "src", rel)]) {
+    if (existsSync6(candidate))
+      return candidate;
+  }
+  return null;
+}
+function inlineIcon(root, ref) {
+  const abs = resolveIconPath(root, ref);
+  if (!abs)
+    return null;
+  const mime = ICON_MIME[extname3(abs).toLowerCase()] || "application/octet-stream";
+  const b64 = readFileSync4(abs).toString("base64");
+  return `data:${mime};base64,${b64}`;
+}
+function inlineManifestIcons(root, raw) {
+  if (isInlineableIcon(raw.icon)) {
+    const data = inlineIcon(root, raw.icon);
+    if (data)
+      raw.icon = data;
+    else
+      console.warn(source_default.yellow(`  Icon not found: ${raw.icon}`));
+  }
+  const nav = raw.navigation;
+  if (nav && isInlineableIcon(nav.icon)) {
+    const data = inlineIcon(root, nav.icon);
+    if (data)
+      nav.icon = data;
+    else
+      console.warn(source_default.yellow(`  navigation.icon not found: ${nav.icon}`));
+  }
+  const pages = raw.pages;
+  if (Array.isArray(pages)) {
+    for (const p of pages) {
+      if (isInlineableIcon(p.icon)) {
+        const data = inlineIcon(root, p.icon);
+        if (data)
+          p.icon = data;
+        else
+          console.warn(source_default.yellow(`  page icon not found: ${p.icon}`));
+      }
+    }
+  }
+}
 async function build(options) {
   const root = process.cwd();
   if (!exists(root)) {
@@ -8470,6 +8535,7 @@ async function build(options) {
   const bundleData = readFileSync4(bundlePath);
   const checksum = createHash("sha256").update(bundleData).digest("hex");
   const raw = readRaw(root);
+  inlineManifestIcons(root, raw);
   const actionsPath = join6(root, "src", "actions.ts");
   if (existsSync6(actionsPath)) {
     const actionMeta = extractActionMetadata(actionsPath);
@@ -11379,7 +11445,7 @@ function graphFork(newSpaceID) {
 // package.json
 var package_default = {
   name: "@construct-space/cli",
-  version: "1.6.2",
+  version: "1.6.3",
   description: "Construct CLI \u2014 scaffold, build, develop, and publish spaces",
   type: "module",
   bin: {

package/dist/templates/space/construct.md.tmpl

@@ -215,7 +215,7 @@ await tasks.remove(id)
 
 ## Actions (agent surface)
 
-`src/actions.ts` exports an `actions` object — each entry becomes an agent-callable tool via `space_run_action`.
+`src/actions.ts` exports an `actions` object — each entry is exposed to the space's agent as a first-class tool.
 
 ```ts
 export const actions = {
@@ -230,7 +230,24 @@ export const actions = {
 }
 ```
 
-The agent (configured in `agent/config.md`) calls `space_list_actions` then `space_run_action`. Keep descriptions tight and specific — they're the only docstring the agent sees.
+### Wiring (REQUIRED — easy to miss)
+
+Each action becomes a tool named **`{spaceID}.{actionName}`** (dot, not underscore). The operator only pre-registers actions that are **explicitly whitelisted** in the agent config. An empty `tools: []` means the agent sees zero action tools and will report "unknown tool".
+
+```yaml
+# agent/config.md frontmatter
+---
+id: {{.ID}}
+tools:
+  - {{.ID}}.createTask
+  - {{.ID}}.listTasks
+  - {{.ID}}.updateTask
+---
+```
+
+Fallback: agents can also discover/invoke actions via the generic `space_list_actions` + `space_run_action` bridge tools. Prefer the whitelist — it gives the model proper tool definitions instead of stringly-typed action names.
+
+Keep action descriptions tight and specific — they're the only docstring the agent sees.
 
 ---
 

package/dist/templates/space/package.json.tmpl

@@ -30,7 +30,7 @@
     "vue-tsc": "^3.2.5"
   },
   "dependencies": {
-    "@construct-space/graph": "^0.5.0",
-    "@construct-space/ui": "^0.5.2"
+    "@construct-space/graph": "^0.6.2",
+    "@construct-space/ui": "^0.6.1"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@construct-space/cli",
-  "version": "1.6.2",
+  "version": "1.6.3",
   "description": "Construct CLI — scaffold, build, develop, and publish spaces",
   "type": "module",
   "bin": {

package/templates/space/construct.md.tmpl

@@ -215,7 +215,7 @@ await tasks.remove(id)
 
 ## Actions (agent surface)
 
-`src/actions.ts` exports an `actions` object — each entry becomes an agent-callable tool via `space_run_action`.
+`src/actions.ts` exports an `actions` object — each entry is exposed to the space's agent as a first-class tool.
 
 ```ts
 export const actions = {
@@ -230,7 +230,24 @@ export const actions = {
 }
 ```
 
-The agent (configured in `agent/config.md`) calls `space_list_actions` then `space_run_action`. Keep descriptions tight and specific — they're the only docstring the agent sees.
+### Wiring (REQUIRED — easy to miss)
+
+Each action becomes a tool named **`{spaceID}.{actionName}`** (dot, not underscore). The operator only pre-registers actions that are **explicitly whitelisted** in the agent config. An empty `tools: []` means the agent sees zero action tools and will report "unknown tool".
+
+```yaml
+# agent/config.md frontmatter
+---
+id: {{.ID}}
+tools:
+  - {{.ID}}.createTask
+  - {{.ID}}.listTasks
+  - {{.ID}}.updateTask
+---
+```
+
+Fallback: agents can also discover/invoke actions via the generic `space_list_actions` + `space_run_action` bridge tools. Prefer the whitelist — it gives the model proper tool definitions instead of stringly-typed action names.
+
+Keep action descriptions tight and specific — they're the only docstring the agent sees.
 
 ---
 

package/templates/space/package.json.tmpl

@@ -30,7 +30,7 @@
     "vue-tsc": "^3.2.5"
   },
   "dependencies": {
-    "@construct-space/graph": "^0.5.0",
-    "@construct-space/ui": "^0.5.2"
+    "@construct-space/graph": "^0.6.2",
+    "@construct-space/ui": "^0.6.1"
   }
 }