@usabledev/usable-chat 1.149.1 → 1.151.0

package/cli.js

@@ -12309,9 +12309,9 @@ var init_markdown = __esm({
         const startNumber = typeof token.start === "number" ? token.start : 1;
         for (let i18 = 0; i18 < token.items.length; i18++) {
           const item = token.items[i18];
-          const bullet2 = token.ordered ? this.options.preserveOrderedListMarkers ? this.getOrderedListMarker(item) ?? `${startNumber + i18}. ` : `${startNumber + i18}. ` : "- ";
+          const bullet3 = token.ordered ? this.options.preserveOrderedListMarkers ? this.getOrderedListMarker(item) ?? `${startNumber + i18}. ` : `${startNumber + i18}. ` : "- ";
           const taskMarker = item.task ? `[${item.checked ? "x" : " "}] ` : "";
-          const marker15 = bullet2 + taskMarker;
+          const marker15 = bullet3 + taskMarker;
           const firstPrefix = indent + this.theme.listBullet(marker15);
           const continuationPrefix = indent + " ".repeat(visibleWidth(marker15));
           const itemWidth = Math.max(1, width - visibleWidth(firstPrefix));
@@ -23746,6 +23746,109 @@ Usable is the user's long-term memory. When a task touches project domain, past
   }
 });
 
+// src/core/orchestrator/harness-compaction.ts
+function toolCallsOf(msg) {
+  const out = [];
+  const m33 = msg;
+  if (Array.isArray(m33.tool_calls)) {
+    for (const tc of m33.tool_calls) {
+      const fn4 = tc.function ?? tc;
+      const name14 = String(fn4.name ?? tc.name ?? "");
+      let args = {};
+      const raw = fn4.arguments ?? tc.args ?? tc.input;
+      if (typeof raw === "string") {
+        try {
+          args = JSON.parse(raw);
+        } catch {
+          args = {};
+        }
+      } else if (raw && typeof raw === "object") {
+        args = raw;
+      }
+      if (name14) out.push({ name: name14, args });
+    }
+  }
+  if (Array.isArray(msg.content)) {
+    for (const part of msg.content) {
+      const type = part.type;
+      if (type === "tool_use" || type === "tool-call") {
+        const name14 = String(part.name ?? part.toolName ?? "");
+        const args = part.input ?? part.args ?? {};
+        if (name14) out.push({ name: name14, args });
+      }
+    }
+  }
+  return out;
+}
+function extractFileOps(messages4) {
+  const read = /* @__PURE__ */ new Set();
+  const modified = /* @__PURE__ */ new Set();
+  for (const msg of messages4) {
+    if (msg.role !== "assistant") continue;
+    for (const { name: name14, args } of toolCallsOf(msg)) {
+      const path11 = args.path ?? args.file ?? args.pattern;
+      if (!path11 || typeof path11 !== "string") continue;
+      if (WRITE_TOOLS.has(name14)) modified.add(path11);
+      else if (READ_TOOLS.has(name14)) read.add(path11);
+    }
+  }
+  return { read: [...read], modified: [...modified] };
+}
+function isStepStart(messages4, i18) {
+  if (i18 <= 0) return false;
+  return messages4[i18].role === "assistant" && messages4[i18 - 1].role !== "assistant";
+}
+function findCutIndex(messages4, keepRecentTokens, countTokens2) {
+  let sum2 = 0;
+  for (let i18 = messages4.length - 1; i18 >= 1; i18--) {
+    sum2 += countTokens2(messages4[i18]);
+    if (sum2 >= keepRecentTokens && isStepStart(messages4, i18)) return i18;
+  }
+  return 0;
+}
+function bullet2(label, items) {
+  if (items.length === 0) return "";
+  const shown = items.slice(0, 30);
+  const more = items.length > shown.length ? ` (+${items.length - shown.length} more)` : "";
+  return `
+${label}: ${shown.join(", ")}${more}`;
+}
+function goalText(messages4) {
+  const first = messages4[0];
+  if (!first || first.role !== "user") return "";
+  if (typeof first.content === "string") return first.content;
+  if (Array.isArray(first.content)) {
+    const text2 = first.content.filter((p28) => p28.type === "text" && typeof p28.text === "string").map((p28) => p28.text).join("\n");
+    return text2;
+  }
+  return "";
+}
+function buildCompactionMarker(goal, droppedCount, fileOps) {
+  const text2 = (goal ? `Original task:
+${goal}
+
+` : "") + `[context-compacted] ${droppedCount} earlier messages were pruned to free the context window; the original task above and the most recent steps are preserved.` + bullet2("Files read so far", fileOps.read) + bullet2("Files modified so far", fileOps.modified) + `
+Continue the task from where it left off \u2014 do NOT restart it. Re-read a file with the read tool if you need its current contents.`;
+  return { role: "user", content: text2 };
+}
+function compactHarnessConversation(messages4, opts) {
+  const minMessages = opts.minMessages ?? 8;
+  if (messages4.length < minMessages) return { messages: messages4, compacted: false, droppedCount: 0 };
+  const cut = findCutIndex(messages4, opts.keepRecentTokens, opts.countTokens);
+  if (cut < 3) return { messages: messages4, compacted: false, droppedCount: 0 };
+  const dropped = messages4.slice(0, cut);
+  const marker15 = buildCompactionMarker(goalText(messages4), dropped.length, extractFileOps(dropped));
+  return { messages: [marker15, ...messages4.slice(cut)], compacted: true, droppedCount: dropped.length };
+}
+var READ_TOOLS, WRITE_TOOLS;
+var init_harness_compaction = __esm({
+  "src/core/orchestrator/harness-compaction.ts"() {
+    "use strict";
+    READ_TOOLS = /* @__PURE__ */ new Set(["read", "glob", "grep"]);
+    WRITE_TOOLS = /* @__PURE__ */ new Set(["write", "edit"]);
+  }
+});
+
 // src/core/orchestrator/ask-user-question-prompt.ts
 var ASK_USER_QUESTION_PROMPT;
 var init_ask_user_question_prompt = __esm({
@@ -157383,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;
@@ -168237,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("");
   }
@@ -168767,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, "");
 }
@@ -168816,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
@@ -168874,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:";
   }
 });
@@ -241711,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 = [
           "",
@@ -241818,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
                   });
                 }
@@ -241861,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",
@@ -242907,6 +243111,37 @@ ${combinedSystemMessage}` : combinedSystemMessage;
             name: msg.name
           };
         };
+        if (config3.localFilesystem) {
+          const harnessCtxLen = getModelById(selectedModelId)?.capabilities.contextLength || 128e3;
+          const envRatio = Number(process.env.USABLE_HARNESS_COMPACT_RATIO);
+          const compactRatio = envRatio > 0 && envRatio <= 1 ? envRatio : HARNESS_COMPACT_RATIO;
+          const tokensOf = (m33) => countTokens(typeof m33.content === "string" ? m33.content : JSON.stringify(m33.content));
+          const estTokens = conversationMessages.reduce((s17, m33) => s17 + tokensOf(m33), 0);
+          if (estTokens > harnessCtxLen * compactRatio) {
+            const beforeLen = conversationMessages.length;
+            const envKeep = Number(process.env.USABLE_HARNESS_KEEP_TOKENS);
+            const keepRecentTokens = envKeep > 0 ? envKeep : Math.floor(harnessCtxLen * HARNESS_KEEP_RECENT_RATIO);
+            const res = compactHarnessConversation(conversationMessages, {
+              keepRecentTokens,
+              countTokens: tokensOf
+            });
+            if (res.compacted) {
+              conversationMessages = ensureToolCallIntegrity(res.messages);
+              orchestrationLogger.warn("\u{1F9F9} Harness proactive compaction", {
+                beforeLen,
+                afterLen: conversationMessages.length,
+                droppedCount: res.droppedCount,
+                estTokens,
+                contextLength: harnessCtxLen
+              });
+              const compactPlan = emitter.emit("plan", {
+                plan: `\u{1F9F9} Compacted ${res.droppedCount} older messages to free context \u2014 continuing.`,
+                steps: config3.maxSteps
+              });
+              multiplexer.send(compactPlan);
+            }
+          }
+        }
         const filteredConversationMessages = filterImagesFromHistory(conversationMessages, {
           preserveLastUserMessageImages: !!modelInfo?.capabilities?.vision
         });
@@ -243096,7 +243331,7 @@ ${combinedSystemMessage}` : combinedSystemMessage;
           });
           multiplexer.send(compactionEvent);
         }
-        if (contextUsagePercent >= 85 && !forceNoTools) {
+        if (contextUsagePercent >= 85 && !forceNoTools && !config3.localFilesystem) {
           forceNoTools = true;
           orchestrationLogger.warn("\u{1F6D1} Context at 85%+ - forcing synthesis, disabling tools", {
             contextUsagePercent: Math.round(contextUsagePercent)
@@ -243857,7 +244092,7 @@ function createOrchestratorRequest(messages4, context, config3, persona, apiKey,
     // Pass MCP tools through
   };
 }
-var HARD_TOOL_RESULT_CEILING_CHARS, ASK_QUESTION_PLACEHOLDER;
+var HARNESS_COMPACT_RATIO, HARNESS_KEEP_RECENT_RATIO, HARD_TOOL_RESULT_CEILING_CHARS, ASK_QUESTION_PLACEHOLDER;
 var init_orchestrator = __esm({
   "src/core/orchestrator/index.ts"() {
     "use strict";
@@ -243868,6 +244103,7 @@ var init_orchestrator = __esm({
     init_config();
     init_code_execution_prompt();
     init_harness_prompt();
+    init_harness_compaction();
     init_ask_user_question_prompt();
     init_artifact_mention_resolver();
     init_slack_mention_resolver();
@@ -243903,6 +244139,8 @@ var init_orchestrator = __esm({
     init_mcp_server_tools_prompt();
     init_spill_payload();
     init_token_counter();
+    HARNESS_COMPACT_RATIO = 0.75;
+    HARNESS_KEEP_RECENT_RATIO = 0.35;
     registerAllExperts();
     HARD_TOOL_RESULT_CEILING_CHARS = 4e4;
     ASK_QUESTION_PLACEHOLDER = "[Awaiting user answer \u2014 picker is open]";
@@ -261445,6 +261683,13 @@ Edit it, then /verify-extension ${arg.trim()} to check it loads, /trust (project
           (it7) => it7.kind === "tool" && it7.id === data2.id ? { ...it7, status: data2.success === false ? "error" : "done", result, error: error41 } : it7
         );
         ui2.requestRender();
+      } else if (e14.type === "plan") {
+        const plan = e14.data?.plan;
+        if (plan && plan.startsWith("\u{1F9F9}")) {
+          finalize();
+          push({ kind: "system", text: plan, tone: "info" });
+          ui2.requestRender();
+        }
       }
     };
     try {
@@ -262279,7 +262524,7 @@ init_tui_select();
 init_model_registry();
 
 // package.json
-var version = "1.149.1";
+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.149.1",
+  "version": "1.151.0",
   "description": "usable-chat — terminal harness for usable-chat (headless + TUI)",
   "type": "module",
   "bin": {