@usabledev/usable-chat 1.150.0 → 1.151.0

package/cli.js

@@ -157486,6 +157486,13 @@ var init_custom_expert = __esm({
         type: external_exports.literal("object"),
         properties: external_exports.record(external_exports.unknown()),
         required: external_exports.array(external_exports.string()).optional()
+      }).optional(),
+      skill: external_exports.object({
+        id: external_exports.string().min(1).max(100).optional(),
+        title: external_exports.string().min(1).max(200).optional(),
+        summary: external_exports.string().max(1e3).optional(),
+        tags: external_exports.array(external_exports.string().min(1).max(100)).max(20).optional(),
+        scope: external_exports.enum(["global", "page"]).optional()
       }).optional()
     });
     MAX_PARENT_TOOLS = 32;
@@ -168340,29 +168347,38 @@ function buildDiscoverableSkillsPromptSection(skills) {
     "",
     "## DISCOVERABLE SKILLS IN CONTEXT",
     "",
-    "You have a catalog of reusable Skills scoped to the workspaces in this conversation. Each entry below lists the skill title, `/<name>` shortcut, UUID, and summary.",
+    "You have a catalog of reusable Skills scoped to this conversation. Workspace skills are Usable fragments. Parent-local skills are provided dynamically by the embedding parent app and must be loaded through their parent tool.",
     "",
     "**BEFORE acting on the user's request, scan this catalog.** If any listed skill matches the user's intent \u2014 by title, `/<name>`, summary keywords, or obvious topical fit \u2014 you MUST use it instead of improvising:",
     "",
-    '1. Call `add-to-conversation-context` with `contextType: "fragment"` and `contextId: <fragmentId>` from the matching entry. Attaching a fragment pulls its FULL instructions into your system prompt for the rest of the conversation \u2014 that\'s how the skill gets "loaded".',
-    "2. Follow that skill's instructions exactly for the current request. Do not fall back to generic search once a matching skill is attached.",
+    '1. For workspace skills, call `add-to-conversation-context` with `contextType: "fragment"` and `contextId: <fragmentId>` from the matching entry. Attaching a fragment pulls its FULL instructions into your system prompt for the rest of the conversation.',
+    "2. For parent-local skills, call the listed `parent_<toolName>` tool first. The parent app returns the current skill instructions/content for this page or application. Follow that returned content exactly.",
+    "3. Do not fall back to generic search once a matching skill is loaded.",
     "",
     '**Example** \u2014 the user asks "what tasks do we have?" and the catalog lists a `/usable-tasks` skill. You MUST attach that skill BEFORE searching for tasks yourself; the skill knows the correct queries, tag taxonomy, and output format.',
     "",
     "**Rules**",
-    "- The entries below are metadata only; their bodies are NOT loaded until you attach them.",
-    "- Load skills lazily \u2014 only attach the one(s) needed for the current request, not the whole catalog.",
-    "- If the user explicitly invokes a skill via `/<name>` or `/skill <uuid>`, the harness has already attached it; just follow its instructions.",
-    '- When a skill-driven task completes (the user moves to a new topic or confirms the work is done), call `remove-from-conversation-context` with `contextType: "fragment"` and the skill\'s fragmentId to free the skill token budget for the next activation.',
+    "- The entries below are metadata only; their bodies are NOT loaded until you attach the workspace fragment or call the parent-local tool.",
+    "- Load skills lazily \u2014 only load the one(s) needed for the current request, not the whole catalog.",
+    "- If the user explicitly invokes a workspace skill via `/<name>` or `/skill <uuid>`, the harness has already attached it; just follow its instructions.",
+    "- If the user explicitly invokes a parent-local skill via `/<name>` or `/skill parent:<id>`, call that skill's parent tool before doing the work.",
+    '- When a workspace skill-driven task completes (the user moves to a new topic or confirms the work is done), call `remove-from-conversation-context` with `contextType: "fragment"` and the skill\'s fragmentId to free the skill token budget for the next activation.',
     ""
   ];
   for (const [workspaceId, workspaceSkills] of skillsByWorkspace.entries()) {
     section.push(`### Workspace: ${workspaceSkills.workspaceName} (\`${workspaceId}\`)`);
     for (const skill of workspaceSkills.skills) {
       const shortcut = skill.name ? ` (\`/${skill.name}\`)` : "";
-      section.push(
-        `- **${skill.title}**${shortcut} \u2014 \`${skill.fragmentId}\`${skill.summary ? ` \u2014 ${skill.summary}` : ""}`
-      );
+      if (skill.source === "parent" && skill.parentToolName) {
+        const scope = skill.parentScope === "global" ? "global" : "page";
+        section.push(
+          `- **${skill.title}**${shortcut} \u2014 parent-local \`${skill.fragmentId}\` \u2014 load with \`parent_${skill.parentToolName}\` \u2014 scope: ${scope}${skill.summary ? ` \u2014 ${skill.summary}` : ""}`
+        );
+      } else {
+        section.push(
+          `- **${skill.title}**${shortcut} \u2014 \`${skill.fragmentId}\`${skill.summary ? ` \u2014 ${skill.summary}` : ""}`
+        );
+      }
     }
     section.push("");
   }
@@ -168870,14 +168886,21 @@ var init_skill_decay = __esm({
 // src/lib/skill-command.ts
 var skill_command_exports = {};
 __export(skill_command_exports, {
+  PARENT_SKILL_COMMAND_ID_REGEX: () => PARENT_SKILL_COMMAND_ID_REGEX,
+  PARENT_SKILL_ID_PREFIX: () => PARENT_SKILL_ID_PREFIX,
   SKILL_COMMAND_UUID_REGEX: () => SKILL_COMMAND_UUID_REGEX,
   addSkillToPendingContext: () => addSkillToPendingContext,
+  buildParentLocalSkillsFromTools: () => buildParentLocalSkillsFromTools,
   buildSkillCommandMessage: () => buildSkillCommandMessage,
   dedupeSkillsByName: () => dedupeSkillsByName,
   ensureSkillConversationContext: () => ensureSkillConversationContext,
   extractSkillName: () => extractSkillName,
-  findSkillByCommandName: () => findSkillByCommandName
+  findSkillByCommandName: () => findSkillByCommandName,
+  isParentLocalSkill: () => isParentLocalSkill
 });
+function isParentLocalSkill(skill) {
+  return skill.source === "parent";
+}
 function kebabCase(value) {
   return value.normalize("NFKD").replace(/[̀-ͯ]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
 }
@@ -168919,11 +168942,43 @@ function buildSkillCommandMessage(skill, userArgs) {
   const name14 = extractSkillName(skill);
   const shortcut = name14 ? ` (\`/${name14}\`)` : "";
   const normalizedArgs = userArgs.trim();
+  if (isParentLocalSkill(skill)) {
+    return [
+      `\u26A1 Activating parent skill **${skill.title}**${shortcut}. Call \`parent_${skill.parentToolName}\` to load and follow the parent-provided skill instructions.`,
+      `Args: ${normalizedArgs || "(none)"}`
+    ].join("\n");
+  }
   return [
     `\u26A1 Activating skill **${skill.title}**${shortcut}. Follow its attached instructions.`,
     `Args: ${normalizedArgs || "(none)"}`
   ].join("\n");
 }
+function buildParentLocalSkillsFromTools(tools) {
+  const skills = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const tool of tools) {
+    if (!tool.skill) continue;
+    const scope = tool.skill.scope ?? "page";
+    const id = (tool.skill.id || tool.name).trim().toLowerCase();
+    if (!/^[a-z][a-z0-9_-]{0,99}$/i.test(id)) continue;
+    const fragmentId = `${PARENT_SKILL_ID_PREFIX}${id}`;
+    if (seen.has(fragmentId)) continue;
+    seen.add(fragmentId);
+    const tags = Array.from(/* @__PURE__ */ new Set(["skill", `skill:${id}`, ...tool.skill.tags || []]));
+    skills.push({
+      source: "parent",
+      fragmentId,
+      workspaceId: scope === "global" ? "parent-global" : "parent-page",
+      workspaceName: scope === "global" ? "Parent app" : "Current page",
+      title: tool.skill.title || id,
+      summary: tool.skill.summary || tool.description,
+      tags,
+      parentToolName: tool.name,
+      parentScope: scope
+    });
+  }
+  return skills;
+}
 function addSkillToPendingContext(pendingContextItems, skill) {
   if (pendingContextItems.some(
     (item) => item.contextType === "fragment" && item.contextId === skill.fragmentId
@@ -168977,11 +169032,13 @@ async function ensureSkillConversationContext(params) {
     throw new Error(`Failed to attach skill context (${addResponse.status})`);
   }
 }
-var SKILL_COMMAND_UUID_REGEX, SKILL_NAME_TAG_PREFIX;
+var SKILL_COMMAND_UUID_REGEX, PARENT_SKILL_ID_PREFIX, PARENT_SKILL_COMMAND_ID_REGEX, SKILL_NAME_TAG_PREFIX;
 var init_skill_command = __esm({
   "src/lib/skill-command.ts"() {
     "use strict";
     SKILL_COMMAND_UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+    PARENT_SKILL_ID_PREFIX = "parent:";
+    PARENT_SKILL_COMMAND_ID_REGEX = /^parent:[a-z][a-z0-9_-]{0,99}$/i;
     SKILL_NAME_TAG_PREFIX = "skill:";
   }
 });
@@ -241814,6 +241871,26 @@ Folder behavior:
           largeContextWarning: contextSizeWarning
         });
       }
+      let discoverableSkillsSectionInjected = false;
+      const buildParentPromptSkills = async () => {
+        if (!context.registeredParentToolSchemas || context.registeredParentToolSchemas.size === 0) {
+          return [];
+        }
+        const { buildParentLocalSkillsFromTools: buildParentLocalSkillsFromTools2, extractSkillName: extractSkillName2 } = await Promise.resolve().then(() => (init_skill_command(), skill_command_exports));
+        return buildParentLocalSkillsFromTools2(
+          Array.from(context.registeredParentToolSchemas.values())
+        ).map((skill) => ({
+          source: "parent",
+          fragmentId: skill.fragmentId,
+          workspaceId: skill.workspaceId,
+          workspaceName: skill.workspaceName,
+          title: skill.title,
+          summary: skill.summary,
+          name: extractSkillName2(skill),
+          parentToolName: skill.parentToolName,
+          parentScope: skill.parentScope
+        }));
+      };
       if (allowedWorkspaceIds.length > 0) {
         const workspaceRules = [
           "",
@@ -241921,18 +241998,25 @@ Folder behavior:
                 });
                 const { dedupeSkillsByName: dedupeSkillsByName2, extractSkillName: extractSkillName2 } = await Promise.resolve().then(() => (init_skill_command(), skill_command_exports));
                 const dedupedSkills = dedupeSkillsByName2(skillDiscovery.skills);
+                const parentPromptSkills = await buildParentPromptSkills();
                 const discoverableSkillsSection = buildDiscoverableSkillsPromptSection(
-                  dedupedSkills.map((skill) => ({
-                    ...skill,
-                    name: extractSkillName2(skill)
-                  }))
+                  [
+                    ...dedupedSkills.map((skill) => ({
+                      source: "workspace",
+                      ...skill,
+                      name: extractSkillName2(skill)
+                    })),
+                    ...parentPromptSkills
+                  ]
                 );
                 if (discoverableSkillsSection) {
                   systemMessageParts.push(discoverableSkillsSection);
+                  discoverableSkillsSectionInjected = true;
                   orchestrationLogger.info("Discoverable skills injected into system prompt", {
                     workspaceCount: new Set(skillDiscovery.skills.map((skill) => skill.workspaceId)).size,
-                    skillCount: dedupedSkills.length,
+                    skillCount: dedupedSkills.length + parentPromptSkills.length,
                     rawSkillCount: skillDiscovery.skills.length,
+                    parentSkillCount: parentPromptSkills.length,
                     stale: skillDiscovery.stale
                   });
                 }
@@ -241964,6 +242048,23 @@ Folder behavior:
           conversationId
         });
       }
+      if (!discoverableSkillsSectionInjected) {
+        try {
+          const parentPromptSkills = await buildParentPromptSkills();
+          const discoverableSkillsSection = buildDiscoverableSkillsPromptSection(parentPromptSkills);
+          if (discoverableSkillsSection) {
+            systemMessageParts.push(discoverableSkillsSection);
+            discoverableSkillsSectionInjected = true;
+            orchestrationLogger.info("Parent-local discoverable skills injected into system prompt", {
+              parentSkillCount: parentPromptSkills.length
+            });
+          }
+        } catch (error41) {
+          orchestrationLogger.warn("Failed to inject parent-local skills into prompt", {
+            error: error41 instanceof Error ? error41.message : String(error41)
+          });
+        }
+      }
       const contextManagementGuidance = [
         "",
         "## CONTEXT WINDOW MANAGEMENT - INTELLIGENT STRATEGY",
@@ -262423,7 +262524,7 @@ init_tui_select();
 init_model_registry();
 
 // package.json
-var version = "1.150.0";
+var version = "1.151.0";
 
 // src/adapters/cli/model-catalog.ts
 init_codex_auth();

package/package.json

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