@usabledev/usable-chat 1.217.0 → 1.217.1

package/cli.js

@@ -176676,6 +176676,9 @@ function isUsableWriteTool(toolName) {
 function extractWorkspaceIds(args) {
   const ids = /* @__PURE__ */ new Set();
   if (typeof args.workspaceId === "string" && args.workspaceId) ids.add(args.workspaceId);
+  if (typeof args.targetWorkspaceId === "string" && args.targetWorkspaceId) {
+    ids.add(args.targetWorkspaceId);
+  }
   if (Array.isArray(args.workspaceIds)) {
     for (const id of args.workspaceIds) if (typeof id === "string" && id) ids.add(id);
   }
@@ -176701,29 +176704,31 @@ function validateUsableToolWorkspace(toolName, args, context3, _isExplicitUserRe
   }
   const workspaceIds = extractWorkspaceIds(args);
   const outsideWorkspaceId = workspaceIds.find((id) => !isWorkspaceAllowed(id, allowedWorkspaces));
-  if (usableToolName === USABLE_WRITE_TOOLS.CREATE || usableToolName === USABLE_WRITE_TOOLS.UPLOAD) {
-    if (workspaceIds.length === 0) {
+  const workspaceWrite = WORKSPACE_WRITE_WORDING[usableToolName];
+  if (workspaceWrite) {
+    const field = workspaceWrite.field ?? "workspaceId";
+    if (typeof args[field] !== "string" || !args[field]) {
       return {
         valid: false,
-        error: `REQUIRED: workspaceId parameter must be specified for ${toolName}. You can only create fragments or upload files in workspaces that are in project or conversation context.`
+        error: `REQUIRED: ${field} parameter must be specified for ${toolName}. You can only ${workspaceWrite.required} in workspaces that are in project or conversation context.`
       };
     }
     if (outsideWorkspaceId) {
       return {
         valid: false,
-        error: `BLOCKED: Cannot ${usableToolName === USABLE_WRITE_TOOLS.UPLOAD ? "upload a file to" : "create fragment in"} workspace ${outsideWorkspaceId} because it is not in project or conversation context. 
+        error: `BLOCKED: Cannot ${workspaceWrite.cannot} workspace ${outsideWorkspaceId} because it is not in project or conversation context. 
 
-**REQUIRED ACTION**: Before ${usableToolName === USABLE_WRITE_TOOLS.UPLOAD ? "uploading files to" : "creating fragments in"} this workspace, you MUST either:
+**REQUIRED ACTION**: Before ${workspaceWrite.before} this workspace, you MUST either:
 1. Ask the user: "The workspace ${outsideWorkspaceId} is not in the current context. Would you like me to add it to the conversation context?"
 2. OR automatically add it to conversation context first using the 'add-to-conversation-context' tool with contextType='workspace' and contextId='${outsideWorkspaceId}'
 
 **Current allowed workspaces**: ${allowedWorkspaces.length > 0 ? allowedWorkspaces.join(", ") : "None"}
 
-Once the workspace is added to context, you can then ${usableToolName === USABLE_WRITE_TOOLS.UPLOAD ? "upload files to" : "create fragments in"} it.`
+Once the workspace is added to context, you can then ${workspaceWrite.then} it.`
       };
     }
   }
-  if (usableToolName === USABLE_WRITE_TOOLS.UPDATE || usableToolName === USABLE_WRITE_TOOLS.ATTACH) {
+  if (FRAGMENT_ADDRESSED_WRITES[usableToolName]) {
     if (outsideWorkspaceId) {
       return {
         valid: false,
@@ -176751,13 +176756,14 @@ function fragmentWriteRefusal(toolName, reason) {
 **REQUIRED ACTION**: Only fragments in workspaces that are in project or conversation context can be changed. If the user wants this fragment changed, ask them whether to add its workspace to the conversation context (the 'add-to-conversation-context' tool with contextType='workspace'), then retry.`
   };
 }
-async function resolveFragmentWriteTarget(toolName, args, resolveFragmentWorkspace) {
-  const fragmentId = typeof args.fragmentId === "string" ? args.fragmentId.trim() : "";
+async function resolveFragmentWriteTarget(toolName, args, idField, resolveFragmentWorkspace) {
+  const raw = args[idField];
+  const fragmentId = typeof raw === "string" ? raw.trim() : "";
   if (!fragmentId) {
-    return fragmentWriteRefusal(toolName, "no fragmentId was given.");
+    return fragmentWriteRefusal(toolName, `no ${idField} was given.`);
   }
   if (!UUID.test(fragmentId)) {
-    return fragmentWriteRefusal(toolName, `fragmentId ${JSON.stringify(fragmentId.slice(0, 64))} is not a fragment id (UUID).`);
+    return fragmentWriteRefusal(toolName, `${idField} ${JSON.stringify(fragmentId.slice(0, 64))} is not a fragment id (UUID).`);
   }
   if (!resolveFragmentWorkspace) {
     return fragmentWriteRefusal(toolName, "the fragment's workspace could not be checked.");
@@ -176785,10 +176791,15 @@ async function resolveFragmentWriteTarget(toolName, args, resolveFragmentWorkspa
 }
 async function validateUsableToolWorkspaceFresh(toolName, args, context3, reload, isExplicitUserRequest = false, resolveFragmentWorkspace) {
   const usableToolName = canonicalUsableToolName(toolName);
-  const isFragmentWrite = usableToolName === USABLE_WRITE_TOOLS.UPDATE || usableToolName === USABLE_WRITE_TOOLS.ATTACH;
+  const fragmentIdField = usableToolName ? FRAGMENT_ADDRESSED_WRITES[usableToolName] : void 0;
   let fragmentWorkspaceId;
-  if (isFragmentWrite && (context3.allowedWorkspaceIds?.length ?? 0) > 0) {
-    const target = await resolveFragmentWriteTarget(toolName, args, resolveFragmentWorkspace);
+  if (fragmentIdField && (context3.allowedWorkspaceIds?.length ?? 0) > 0) {
+    const target = await resolveFragmentWriteTarget(
+      toolName,
+      args,
+      fragmentIdField,
+      resolveFragmentWorkspace
+    );
     if ("valid" in target) return target;
     fragmentWorkspaceId = target.workspaceId;
   }
@@ -176836,7 +176847,7 @@ async function recordWorkspaceAddedToContext(context3, toolName, args, result, r
   );
   if (fresh.length > 0) context3.allowedWorkspaceIds = [...current, ...new Set(fresh)];
 }
-var UUID, USABLE_WRITE_TOOLS;
+var UUID, USABLE_WRITE_TOOLS, WORKSPACE_WRITE_WORDING, FRAGMENT_ADDRESSED_WRITES;
 var init_usable_validation = __esm({
   "src/core/tools/usable-validation.ts"() {
     "use strict";
@@ -176846,7 +176857,74 @@ var init_usable_validation = __esm({
       CREATE: "create-memory-fragment",
       UPDATE: "update-memory-fragment",
       ATTACH: "attach-file-to-fragment",
-      UPLOAD: "request-upload-url"
+      UPLOAD: "request-upload-url",
+      IMPORT_IMAGES: "import-image-fragments",
+      IMPORT_FRAGMENT: "request-fragment-import",
+      CREATE_COLLECTION: "create-collection",
+      UPDATE_COLLECTION: "update-collection",
+      CREATE_FRAGMENT_TYPE: "create-fragment-type",
+      UPDATE_FRAGMENT_TYPE: "update-fragment-type",
+      UPDATE_WORKSPACE: "update-workspace",
+      CREATE_SYMLINK: "create-fragment-symlink",
+      REMOVE_SYMLINK: "remove-fragment-symlink",
+      PREPARE_PUBLIC_FRAGMENT: "prepare-public-fragment",
+      PREPARE_PUBLIC_SITE: "prepare-public-site",
+      REQUEST_PUBLICATION: "request-public-site-publication",
+      WITHDRAW_PUBLIC_SITE: "withdraw-public-site"
+    };
+    WORKSPACE_WRITE_WORDING = {
+      [USABLE_WRITE_TOOLS.CREATE]: {
+        required: "create fragments or upload files",
+        cannot: "create fragment in",
+        before: "creating fragments in",
+        then: "create fragments in"
+      },
+      [USABLE_WRITE_TOOLS.UPLOAD]: {
+        required: "create fragments or upload files",
+        cannot: "upload a file to",
+        before: "uploading files to",
+        then: "upload files to"
+      },
+      [USABLE_WRITE_TOOLS.IMPORT_IMAGES]: {
+        required: "import images",
+        cannot: "import images into",
+        before: "importing images into",
+        then: "import images into"
+      },
+      [USABLE_WRITE_TOOLS.IMPORT_FRAGMENT]: {
+        required: "import fragments",
+        cannot: "import a fragment into",
+        before: "importing fragments into",
+        then: "import fragments into"
+      },
+      ...Object.fromEntries(
+        [
+          [USABLE_WRITE_TOOLS.CREATE_COLLECTION, "create collections"],
+          [USABLE_WRITE_TOOLS.UPDATE_COLLECTION, "change collections"],
+          [USABLE_WRITE_TOOLS.CREATE_FRAGMENT_TYPE, "create fragment types"],
+          [USABLE_WRITE_TOOLS.UPDATE_FRAGMENT_TYPE, "change fragment types"],
+          [USABLE_WRITE_TOOLS.UPDATE_WORKSPACE, "change workspace settings"],
+          [USABLE_WRITE_TOOLS.PREPARE_PUBLIC_FRAGMENT, "prepare public pages"],
+          [USABLE_WRITE_TOOLS.PREPARE_PUBLIC_SITE, "prepare public sites"],
+          [USABLE_WRITE_TOOLS.REQUEST_PUBLICATION, "publish"],
+          [USABLE_WRITE_TOOLS.WITHDRAW_PUBLIC_SITE, "withdraw public sites"]
+        ].map(([tool2, action5]) => [
+          tool2,
+          { required: action5, cannot: `${action5} in`, before: `you ${action5} in`, then: `${action5} in` }
+        ])
+      ),
+      [USABLE_WRITE_TOOLS.CREATE_SYMLINK]: {
+        field: "targetWorkspaceId",
+        required: "create symlinks",
+        cannot: "create a symlink in",
+        before: "creating symlinks in",
+        then: "create symlinks in"
+      }
+    };
+    FRAGMENT_ADDRESSED_WRITES = {
+      [USABLE_WRITE_TOOLS.UPDATE]: "fragmentId",
+      [USABLE_WRITE_TOOLS.ATTACH]: "fragmentId",
+      [USABLE_WRITE_TOOLS.REMOVE_SYMLINK]: "childFragmentId"
     };
   }
 });
@@ -289655,6 +289733,24 @@ var init_tool_categories = __esm({
       "request-upload-url",
       "attach-file-to-fragment",
       "save-chat-file-to-fragment",
+      // Usable's other writes. The MCP bridge registers them under their plain names,
+      // which the mutating-name fallback below (mcp_-prefixed only) never sees.
+      "import-image-fragments",
+      "request-fragment-import",
+      "create-collection",
+      "update-collection",
+      "create-fragment-symlink",
+      "remove-fragment-symlink",
+      "update-fragment-type",
+      "create-workspace",
+      "update-workspace",
+      "subscribe-to-workspace",
+      "manage-application",
+      "manage-installation-spend-credential",
+      "prepare-public-fragment",
+      "prepare-public-site",
+      "request-public-site-publication",
+      "withdraw-public-site",
       "create-embed-config",
       "update-embed-config",
       "create-custom-expert",
@@ -289931,6 +290027,7 @@ CRITICAL: You are in DISCUSSION MODE (read-only). This is a hard constraint you
 
 FORBIDDEN \u2014 these tools are REMOVED and do not exist:
 - create-memory-fragment, update-memory-fragment, request-upload-url, attach-file-to-fragment, save-chat-file-to-fragment
+- import-image-fragments, request-fragment-import, and Usable's collection, workspace, public-site and symlink writes
 
 You MUST NEVER claim or imply you performed any write action. Do NOT hallucinate success.
 
@@ -369861,6 +369958,7 @@ FORBIDDEN actions \u2014 you do NOT have these tools and MUST NOT pretend you do
 - Uploading files (request-upload-url is REMOVED)
 - Attaching files (attach-file-to-fragment is REMOVED)
 - Saving chat files to fragments (save-chat-file-to-fragment is REMOVED)
+- Importing, publishing or organizing (import-image-fragments, request-fragment-import, collections, workspaces, public sites and symlinks are REMOVED)
 
 You MUST NEVER claim or imply you performed any of these actions. Do NOT hallucinate success. Do NOT say "Done!" for write operations. The tools literally do not exist in your current tool set.
 
@@ -369919,6 +370017,7 @@ FORBIDDEN actions \u2014 these tools are REMOVED and you MUST NOT pretend you ha
 - Uploading files (request-upload-url is REMOVED)
 - Attaching files (attach-file-to-fragment is REMOVED)
 - Saving chat files to fragments (save-chat-file-to-fragment is REMOVED)
+- Importing, publishing or organizing (import-image-fragments, request-fragment-import, collections, workspaces, public sites and symlinks are REMOVED)
 - Generating images (generate-image is REMOVED)
 
 You MUST NEVER claim or imply you performed any of these actions.
@@ -372484,7 +372583,7 @@ When creating or searching for fragments, use these fragment type IDs:
         theme: {
           primary: "#fcaf2a",
           // Usable orange
-          accent: "#347cbf"
+          accent: "#2e70b0"
           // Usable blue
         },
         displayName: "Usable Assistant",
@@ -395068,7 +395167,7 @@ init_tui_select();
 init_model_registry();
 
 // package.json
-var version2 = "1.217.0";
+var version2 = "1.217.1";
 
 // src/adapters/cli/model-catalog.ts
 init_codex_auth();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usabledev/usable-chat",
-  "version": "1.217.0",
+  "version": "1.217.1",
   "description": "usable-chat — terminal harness for usable-chat (headless + TUI)",
   "type": "module",
   "bin": {