buckyos 0.7.151 → 0.7.153

package/cli/dist/cli.mjs

@@ -4816,7 +4816,33 @@ function validateObjectGraph(appDoc, packageMeta, payloads, hasJson, hasSigned,
     canonicalMatch
   };
 }
+function validateAppPresentation(value, label) {
+  const presentation = expectObject$3(value, label);
+  rejectUnknown(presentation, ["title", "summary", "description", "icons", "links", "license"], label);
+  for (const field of ["title", "summary", "description", "icons", "links"]) {
+    const values = expectObject$3(presentation[field], `${label}.${field}`);
+    for (const [key, item] of Object.entries(values)) {
+      if (typeof item !== "string") {
+        throw invalid("appdoc", `${label}.${field}.${key} must be a string`);
+      }
+      if (field === "icons") {
+        try {
+          ndn.ObjId.fromString(item);
+        } catch {
+          throw invalid("appdoc", `${label}.${field}.${key} must be an ObjectId`);
+        }
+      }
+    }
+  }
+  if (typeof presentation.license !== "string") {
+    throw invalid("appdoc", `${label}.license must be a string`);
+  }
+  return presentation;
+}
 function validateAppDocShape(appDoc) {
+  if (appDoc.presentation !== void 0 && appDoc.presentation !== null) {
+    validateAppPresentation(appDoc.presentation, "APPDOC.presentation");
+  }
   rejectUnknown(
     appDoc,
     [
@@ -5179,7 +5205,7 @@ function validateContentHandlers(value, permissions) {
   }
   return value;
 }
-const PACKAGE_VERSION = "0.7.151";
+const PACKAGE_VERSION = "0.7.153";
 const TOOL_VERSION = PACKAGE_VERSION;
 const SDK_VERSION = PACKAGE_VERSION;
 const PROTOCOL_VERSION = "1";
@@ -5748,6 +5774,7 @@ async function buildCommand(ctx, input, docker, now) {
       categories: appMeta.categories,
       pkg_list: pkgList,
       show_name: appMeta.show_name,
+      ...appMeta.presentation ? { presentation: appMeta.presentation } : {},
       ...appMeta.permissions.length ? { permissions: appMeta.permissions } : {},
       ...appMeta.content_handlers?.length ? { content_handlers: appMeta.content_handlers } : {},
       selector_type: appMeta.selector_type,
@@ -5911,6 +5938,7 @@ function parseAppMeta(value) {
       "owner",
       "author",
       "show_name",
+      "presentation",
       "categories",
       "permissions",
       "content_handlers",
@@ -5953,6 +5981,11 @@ function parseAppMeta(value) {
     owner,
     author: developmentString(value.author, "app.json.author"),
     show_name: developmentString(value.show_name, "app.json.show_name"),
+    ...value.presentation === void 0 ? {} : {
+      presentation: developmentValidation(
+        () => validateAppPresentation(value.presentation, "app.json.presentation")
+      )
+    },
     categories,
     permissions,
     ...value.content_handlers === void 0 ? {} : { content_handlers: developmentValidation(() => validateContentHandlers(value.content_handlers, permissions)) },
@@ -8336,7 +8369,7 @@ function createDiagnosticModule(dependencies = {}) {
   return {
     name: "diagnostic",
     summary: "Collect and export privileged redacted diagnostic bundles",
-    commands: [collectCommand(), exportCommand$1(dependencies)]
+    commands: [collectCommand(), exportCommand$2(dependencies)]
   };
 }
 function collectCommand() {
@@ -8404,7 +8437,7 @@ function collectCommand() {
     }
   };
 }
-function exportCommand$1(dependencies) {
+function exportCommand$2(dependencies) {
   return {
     verb: "export",
     summary: "Export one diagnostic bundle to a new file",
@@ -8476,7 +8509,7 @@ function createLogModule(dependencies = {}) {
       servicesCommand(),
       queryCommand$1(),
       tailCommand(dependencies),
-      exportCommand(dependencies)
+      exportCommand$1(dependencies)
     ]
   };
 }
@@ -8604,7 +8637,7 @@ function tailCommand(dependencies) {
     }
   };
 }
-function exportCommand(dependencies) {
+function exportCommand$1(dependencies) {
   return {
     verb: "export",
     summary: "Export a bounded redacted log archive to a new file",
@@ -11215,11 +11248,103 @@ const runReportCommand = {
     return aiws(ctx, "proc.report", params);
   }
 };
+const controlsCommand = {
+  verb: "controls",
+  summary: "Block-controls a canvas offers: `list` (kind, what it is, when to use it), `describe <kind>` (the full self-description to follow)",
+  positionals: [{ name: "action", description: "list | describe", required: true }, { name: "kind", description: "Control kind for describe, e.g. mindmap", required: false }],
+  options: [],
+  inputSchema: { type: "object", properties: { action: { type: "string", enum: ["list", "describe"] }, kind: { type: "string" } }, required: ["action"], additionalProperties: false },
+  outputSchema: OBJECT_OUTPUT,
+  resultSchemaVersion: 1,
+  access: { mode: "fixed", level: "read" },
+  asyncMode: "sync",
+  requiresSession: true,
+  examples: ["buckyos aiws controls list", "buckyos aiws controls describe mindmap"],
+  handler: (ctx, input) => {
+    const action = requiredInputString(input, "action");
+    if (action === "list")
+      return aiws(ctx, "control.list", {});
+    if (action !== "describe")
+      throw new UsageError("AIWS_USAGE", "controls: list or describe <kind>");
+    return aiws(ctx, "control.describe", { kind: requiredInputString(input, "kind") });
+  }
+};
+function exchangeFormat(explicit, file) {
+  if (explicit)
+    return explicit;
+  return /\.(opml|xml)$/i.test(file) ? "opml" : "markdown";
+}
+const importCommand = {
+  verb: "import",
+  summary: "Create a Block-control from an exchange file: a mind map from a Markdown outline (nested list) or OPML",
+  positionals: [{ name: "file", description: "Local file (.md / .opml)", required: true }],
+  options: [
+    WORKSPACE_OPTION,
+    { name: "parent", property: "parent_id", description: "Surface (or group) id to put the control on", type: "string", required: true },
+    { name: "kind", property: "kind", description: "Control kind (default mindmap)", type: "string" },
+    { name: "format", property: "format", description: "markdown | opml (default: by the file extension)", type: "string", enum: ["markdown", "opml"] },
+    { name: "at", property: "at", description: "x,y on a free canvas: where the first root goes", type: "string" },
+    { name: "title", property: "title", description: "Title of the control (default: the single root, or the OPML title)", type: "string" }
+  ],
+  inputSchema: workspaceInput({ file: { type: "string", minLength: 1 }, parent_id: { type: "string", minLength: 1 }, kind: { type: "string" }, format: { type: "string" }, at: { type: "string" }, title: { type: "string" } }, ["file", "parent_id"]),
+  outputSchema: OBJECT_OUTPUT,
+  resultSchemaVersion: 1,
+  access: { mode: "fixed", level: "write" },
+  asyncMode: "sync",
+  requiresSession: true,
+  examples: ["buckyos aiws import plan.md --workspace ws_abc --parent sf_main --at 100,80", "buckyos aiws import ideas.opml --workspace ws_abc --parent sf_main"],
+  handler: async (ctx, input) => {
+    const file = requiredInputString(input, "file");
+    const params = {
+      workspace_id: requiredInputString(input, "workspace_id"),
+      parent_id: requiredInputString(input, "parent_id"),
+      kind: inputString(input, "kind") ?? "mindmap",
+      format: exchangeFormat(inputString(input, "format"), file),
+      text: await getHost().readTextFile(file)
+    };
+    const at = inputString(input, "at");
+    if (at) {
+      const [x, y] = at.split(",").map(Number);
+      if (!Number.isFinite(x) || !Number.isFinite(y))
+        throw new UsageError("AIWS_USAGE", "--at is x,y");
+      params.at = { x, y };
+    }
+    const title = inputString(input, "title");
+    if (title)
+      params.title = title;
+    return aiws(ctx, "control.import", params);
+  }
+};
+const exportCommand = {
+  verb: "export",
+  summary: "A Block-control in an exchange format: a mind map as a Markdown outline or OPML",
+  positionals: [{ name: "entity_id", description: "The control (container) id", required: true }],
+  options: [
+    WORKSPACE_OPTION,
+    { name: "format", property: "format", description: "markdown (default) | opml", type: "string", enum: ["markdown", "opml"] },
+    { name: "out", property: "out", description: "Write the text to this file instead of answering it", type: "string" }
+  ],
+  inputSchema: workspaceInput({ entity_id: { type: "string", minLength: 1 }, format: { type: "string" }, out: { type: "string" } }, ["entity_id"]),
+  outputSchema: OBJECT_OUTPUT,
+  resultSchemaVersion: 1,
+  access: { mode: "fixed", level: "read" },
+  asyncMode: "sync",
+  requiresSession: true,
+  examples: ["buckyos aiws export mm_plan --workspace ws_abc", "buckyos aiws export mm_plan --workspace ws_abc --format opml --out plan.opml"],
+  handler: async (ctx, input) => {
+    const result = await aiws(ctx, "control.export", { workspace_id: requiredInputString(input, "workspace_id"), entity_id: requiredInputString(input, "entity_id"), format: inputString(input, "format") ?? "markdown" });
+    const out = inputString(input, "out");
+    if (!out)
+      return result;
+    await getHost().writeTextFile(out, String(result.text ?? ""));
+    return { ok: true, format: result.format, kind: result.kind, path: out };
+  }
+};
 function createAiwsModule() {
   return {
     name: "aiws",
-    summary: "AI Workspace: read a workspace, and execute wish runs as their executor (claim, heartbeat, report)",
-    commands: [infoCommand, readCommand, queryCommand, runGetCommand, runClaimCommand, runHeartbeatCommand, runFilesCommand, runToolCommand, runProgramCommand, runReportCommand]
+    summary: "AI Workspace: read a workspace, Block-controls (catalogue, import, export), and execute wish runs as their executor (claim, heartbeat, report)",
+    commands: [infoCommand, readCommand, queryCommand, controlsCommand, importCommand, exportCommand, runGetCommand, runClaimCommand, runHeartbeatCommand, runFilesCommand, runToolCommand, runProgramCommand, runReportCommand]
   };
 }
 const VERSION = TOOL_VERSION;