@qvac/harness 0.8.7 → 0.8.9

package/CHANGELOG.md

@@ -8,6 +8,61 @@ While the major version is `0`, a breaking change bumps the minor version.
 
 ## [Unreleased]
 
+## [0.8.9] - 2026-10-15
+
+### Changed
+
+- A skill with a `display_name` answers only to that handle; a skill without
+  one still answers to its folder name. `@documents` resolves the word skill
+  and `@word` no longer does, which replaces the 0.8.8 note that both resolve.
+  Implicit preload skips a leading `@name`, so a handle that resolves to no
+  skill loads nothing, while a plain "make an excel sheet" still preloads
+  Spreadsheets. A paired device on an older app build still sends `@word` and
+  `@excel`; once the skills package declares `display_name`, a host on this
+  version answers those requests without the skill. (#505)
+- `@qvac/skills` 0.1.15: the Word and Excel skills declare `display_name`, so
+  their handles are `@documents` and `@spreadsheets`. The browser skill hands a
+  CAPTCHA, interstitial or login page to the user instead of clicking through
+  or waiting, and keeps its Chrome cookies and logins across chats. (#513)
+
+## [0.8.8] - 2026-10-15
+
+### Added
+
+- A skill's manifest may declare `display_name`, the `@` handle users see and
+  type, as one word (letters, digits, `-` or `_`); a `display_name` that is
+  not one word is ignored. The Word and Excel skills are shown as Documents
+  and Spreadsheets, and their folder names are trademarks, so a host needs a
+  handle other than the name. Once the word skill's manifest declares
+  `display_name: Documents`, `@documents` resolves it, and `@word` still does,
+  so an app that sends the folder name keeps working. The catalog entry and
+  the `skills` wire carry `displayName`, a customized copy of a skill keeps
+  the shipped one, and `skillMentionHandle` gives a host the same rule the
+  harness matches on. The folder name stays the skill's key everywhere else.
+  (#469)
+
+### Fixed
+
+- A replayed tool call keeps its markup when history is rendered from scratch.
+  Every assistant turn lost its tool-call markup on the way in, so a retry,
+  compaction, a dropped chat cache, an overflow candidate or another device
+  showed the model an empty assistant turn followed by a result answering
+  nothing. Only an assistant turn that no tool result follows is stripped now,
+  which still keeps markup leaked into a final answer out of the prompt. (#402)
+- A web search the harness runs for "search the web" now ends on the same
+  continuation nudge as a search the model makes. Without it, the round after
+  the search often failed on Qwen3.5-9B with thinking on instead of answering.
+  (#486)
+- An identical call to a read tool that already succeeded this turn is
+  answered with a note pointing at the earlier result instead of running
+  again, and counts as a strike. A small model could repeat the same call
+  hundreds of times in one round until the context filled. Any other tool
+  that runs clears the memo, and a round is cut to its first 16 calls. (#377)
+- Asking the `skill` tool for a file a loaded skill does not have returns
+  guidance listing its real files instead of an error, so the app no longer
+  shows a failed tool call for it. A file asked of an unknown skill returns
+  `skill not found`. (#383)
+
 ## [0.8.7] - 2026-10-12
 
 ### Added
@@ -1953,7 +2008,9 @@ Install 0.2.12 or later to get them.
 - Every dependency installs from the public npm registry: GPU stats are read
   through `bare-gpu-info`. (#12)
 
-[Unreleased]: https://github.com/tetherto/qvac-harness/compare/v0.8.7...HEAD
+[Unreleased]: https://github.com/tetherto/qvac-harness/compare/v0.8.9...HEAD
+[0.8.9]: https://github.com/tetherto/qvac-harness/compare/v0.8.8...v0.8.9
+[0.8.8]: https://github.com/tetherto/qvac-harness/compare/v0.8.7...v0.8.8
 [0.8.7]: https://github.com/tetherto/qvac-harness/compare/v0.8.6...v0.8.7
 [0.8.6]: https://github.com/tetherto/qvac-harness/compare/v0.8.5...v0.8.6
 [0.8.5]: https://github.com/tetherto/qvac-harness/compare/v0.8.0...v0.8.5

package/dist-lib/lib/capabilities/completion.d.ts

@@ -185,6 +185,7 @@ export interface ToolDefinition {
     toolset: Toolset | null;
     validate?: (args: Record<string, unknown>, ctx?: ToolExecuteContext) => string | null;
     effect: (args: Record<string, unknown>, ctx?: ToolExecuteContext) => ToolEffect;
+    stableRead?: true;
     resource?: (args: Record<string, unknown>, ctx?: ToolExecuteContext) => ResourceDescriptor | null;
     compiled?: true;
     execute: (args: Record<string, unknown>, ctx?: ToolExecuteContext) => Promise<unknown>;

package/dist-lib/lib/capabilities/completion.js

@@ -60,6 +60,9 @@ const MAX_MUTE_ROUNDS = 1;
 const NARRATED_INTENT = /\b(I['’]ll|I will|Now I|Let me(?! know)|Next,? I)\b[^.!?]*[.!?]?\s*$/i;
 const MAX_WEB_SEARCHES_PER_TURN = 3;
 const MAX_CAPPED_ROUNDS = 1;
+const MAX_CALLS_PER_ROUND = 16;
+const repeatedReadMessage = (name) => `The result of this exact ${name} call is already above. Answer from it now; ` +
+    `do not call ${name} again with the same arguments.`;
 const WEB_SEARCH_LIMIT_MESSAGE = 'Web search limit reached for this question. Answer now from the results already gathered. ' +
     'If something was not found, say so plainly and mention the most relevant sources. ' +
     'Do not call web_search again.';
@@ -101,9 +104,10 @@ export function toSdkTool(tool) {
         parameters: intentParameters(tool, tool.prompt?.parameters ?? tool.parameters)
     };
 }
-function sanitizeTurn(turn) {
+function sanitizeTurn(turn, index, turns) {
     const stripped = stripControlTokens(turn.content);
-    const content = turn.role === 'assistant' ? stripToolCallMarkup(stripped) : stripped;
+    const leaked = turn.role === 'assistant' && turns[index + 1]?.role !== 'tool';
+    const content = leaked ? stripToolCallMarkup(stripped) : stripped;
     return content === turn.content ? turn : { ...turn, content };
 }
 function lastUserContent(messages) {
@@ -143,7 +147,8 @@ function directToolHistory(history, call, output) {
     return [
         ...history,
         { role: 'assistant', content: toolCallMarkup([call]) },
-        { role: 'tool', content: toolResultTurn(call.name, DIRECT_CALL_ID, output) }
+        { role: 'tool', content: toolResultTurn(call.name, DIRECT_CALL_ID, output) },
+        { role: 'user', content: TOOL_CONTINUATION_NUDGE }
     ];
 }
 function assistantToolTurn(contentText, calls) {
@@ -203,12 +208,19 @@ function deniedResult() {
 }
 function callKey(name, args) {
     try {
-        return `${name}:${JSON.stringify(args)}`;
+        return `${name}:${JSON.stringify(args, sortedKeys)}`;
     }
     catch {
         return name;
     }
 }
+function sortedKeys(_key, value) {
+    if (!isRecord(value) || Array.isArray(value))
+        return value;
+    return Object.fromEntries(Object.keys(value)
+        .sort()
+        .map((key) => [key, value[key]]));
+}
 const RETRYABLE_STATUS = new Set([408, 429]);
 const RETRYABLE_CODE = new Set(['timeout', 'transport', 'busy']);
 function callSucceeded(result, outcome) {
@@ -875,12 +887,12 @@ export async function* completion(sdk, { modelId, acquireRound, model, agent, ct
         let history = annotateLastUserTime(systemContent ? [{ role: 'system', content: systemContent }, ...messages] : messages);
         if (preload && preloadedSkill !== null) {
             history = directToolHistory(history, { name: SKILL_TOOL_NAME, arguments: { name: preload.name } }, preloadedResult);
-            history.push({ role: 'user', content: TOOL_CONTINUATION_NUDGE });
         }
         let roundCacheKey = cacheKey;
         const runUsage = () => usageBreakdown(promptParts, stats.cacheTokens, model);
         const denied = new Set();
         const failed = new Map();
+        const answered = new Set();
         let blockedRepeats = 0;
         let webSearches = 0;
         const sources = trustedSourcesFrom(history);
@@ -939,6 +951,9 @@ export async function* completion(sdk, { modelId, acquireRound, model, agent, ct
             if (fold.ok) {
                 webSearches++;
             }
+            if (webSearch.stableRead && execution.executed && callSucceeded(output, executionOutcome)) {
+                answered.add(callKey(webSearch.name, args));
+            }
             if (!activity && !fold.ok) {
                 activity = {
                     type: 'tool-activity',
@@ -1074,6 +1089,10 @@ export async function* completion(sdk, { modelId, acquireRound, model, agent, ct
             }
             mute = 0;
             narrated = false;
+            if (toolCalls.length > MAX_CALLS_PER_ROUND) {
+                hlog('round over the call cap; the rest are dropped', { round, calls: toolCalls.length });
+                toolCalls = toolCalls.slice(0, MAX_CALLS_PER_ROUND);
+            }
             const resolved = await resolveToolCalls(toolCalls, {
                 enabled,
                 agentId: agent?.id ?? null,
@@ -1099,7 +1118,8 @@ export async function* completion(sdk, { modelId, acquireRound, model, agent, ct
             for (const { call, tool, args, rawCall, rejection, intent } of resolved) {
                 if (signal?.aborted)
                     throw new AbortedError();
-                const priorFailure = failed.get(callKey(call.name, args));
+                const key = callKey(call.name, args);
+                const priorFailure = failed.get(key);
                 const searchCapped = tool?.name === WEB_SEARCH_TOOL_NAME && webSearches >= MAX_WEB_SEARCHES_PER_TURN;
                 const callCtx = {
                     ...toolContext(turnImages, ctxSize),
@@ -1115,6 +1135,8 @@ export async function* completion(sdk, { modelId, acquireRound, model, agent, ct
                 };
                 const skillCall = call.name === SKILL_TOOL_NAME;
                 const effect = tool?.effect(args, callCtx) ?? (skillCall ? 'read' : undefined);
+                const stableRead = tool?.stableRead === true && effect === 'read';
+                const priorSuccess = !priorFailure && stableRead && answered.has(key);
                 const resource = tool?.resource?.(args) ?? null;
                 const skillName = unquoteArg(args?.name ?? args?.skill_name ?? args?.skill);
                 const askedFile = skillFileArg(args);
@@ -1123,7 +1145,7 @@ export async function* completion(sdk, { modelId, acquireRound, model, agent, ct
                     (mainRequested
                         ? loadedThisTurn.has(skillName)
                         : loadedFilesThisTurn.has(fileKey(skillName, unquoteArg(askedFile))));
-                const silent = searchCapped || skillReloaded || priorFailure !== undefined;
+                const silent = searchCapped || skillReloaded || priorFailure !== undefined || priorSuccess;
                 const display = silent
                     ? undefined
                     : labelOf(call.name, args, skillCall ? skillEmoji(skillName) : skillIcon);
@@ -1145,6 +1167,14 @@ export async function* completion(sdk, { modelId, acquireRound, model, agent, ct
                     });
                     execution = terminalCall(priorFailure.result, priorFailure.outcome, { executed: false });
                 }
+                else if (priorSuccess) {
+                    blockedRepeats++;
+                    hlog('repeat of a read that already answered; not run again', {
+                        tool: call.name,
+                        blockedRepeats
+                    });
+                    execution = terminalCall({ content: repeatedReadMessage(call.name) }, { kind: 'success' }, { executed: false });
+                }
                 else if (skillReloaded) {
                     const loadedWhat = mainRequested ? skillName : `${skillName} ${unquoteArg(askedFile)}`;
                     execution = terminalCall({
@@ -1196,18 +1226,27 @@ export async function* completion(sdk, { modelId, acquireRound, model, agent, ct
                 const output = settled.result;
                 const executionOutcome = settled.outcome;
                 if (!priorFailure && settledFailure(output, executionOutcome)) {
-                    failed.set(callKey(call.name, args), settled);
+                    failed.set(key, settled);
                 }
                 else if (execution.executed && callSucceeded(output, executionOutcome)) {
                     progressed = true;
                     answer ??= answerOf(output);
                 }
+                if (execution.executed && !stableRead && !skillCall) {
+                    answered.clear();
+                }
+                else if (stableRead && execution.executed && callSucceeded(output, executionOutcome)) {
+                    answered.add(key);
+                }
                 runOutcomes.record(output, executionOutcome);
                 if (searchCapped) {
                     cappedCalls++;
                     hlog('web_search capped', { searches: webSearches });
                 }
-                else if (tool?.name === WEB_SEARCH_TOOL_NAME && !rejection && !priorFailure) {
+                else if (tool?.name === WEB_SEARCH_TOOL_NAME &&
+                    !rejection &&
+                    !priorFailure &&
+                    !priorSuccess) {
                     webSearches++;
                 }
                 if (call.name === SKILL_TOOL_NAME) {

package/dist-lib/lib/connect.js

@@ -511,6 +511,7 @@ export class RemoteHarness extends EventEmitter {
             }));
             return {
                 name: skill.name,
+                displayName: skill.displayName || undefined,
                 description: skill.description,
                 tools: skill.tools ?? [],
                 credentials: skill.credentials ?? [],

package/dist-lib/lib/serve.js

@@ -236,6 +236,7 @@ function toWireSkill(skill) {
     }));
     return {
         name: skill.name,
+        displayName: skill.displayName || undefined,
         description: skill.description,
         tools: skill.tools,
         credentials: skill.credentials,

package/dist-lib/lib/tools/file-glob.js

@@ -57,6 +57,7 @@ export function createFileGlobTool({ realpath = defaultRealpath, deniedRoots } =
             required: ['pattern']
         },
         effect: () => 'read',
+        stableRead: true,
         autoApprove: true,
         rootsRequired: true,
         validate(rawArgs) {

package/dist-lib/lib/tools/grep.js

@@ -99,6 +99,7 @@ export function createGrepTool({ realpath = defaultRealpath, deniedRoots } = {})
             required: ['queries']
         },
         effect: () => 'read',
+        stableRead: true,
         autoApprove: true,
         rootsRequired: true,
         validate(rawArgs) {

package/dist-lib/lib/tools/read-files.js

@@ -91,6 +91,7 @@ export function createReadFilesTool({ realpath = defaultRealpath, deniedRoots }
             required: ['files']
         },
         effect: () => 'read',
+        stableRead: true,
         autoApprove: true,
         rootsRequired: true,
         validate(rawArgs) {

package/dist-lib/lib/tools/skill.js

@@ -185,12 +185,14 @@ export function createSkillTool({ skillsDir, overlayDir = resolveSkillsOverlayDi
                     try {
                         return await mainInstead(file, available);
                     }
-                    catch { }
+                    catch {
+                        return { error: `skill not found: ${name}` };
+                    }
                 }
                 const rest = available.length
-                    ? ` — files this skill has: ${available.join(', ')}`
-                    : '. This skill has no other files; you already have its full instructions — act now.';
-                return { error: `file not found in skill ${name}: ${file}${rest}` };
+                    ? `Its other files: ${available.join(', ')}.`
+                    : 'It has no other files; you already have its full instructions, so act now.';
+                return { name, content: `There is no file ${file} in this skill. ${rest}` };
             }
         }
     };

package/dist-lib/lib/tools/skills/catalog.d.ts

@@ -9,6 +9,7 @@ import { type OperationSpec } from '../operations/manifest.ts';
 import type { CapabilityProfile } from '../../models/model-catalog.ts';
 export interface SkillCatalogEntry {
     name: string;
+    displayName?: string;
     description: string;
     aliases?: string[];
     preloadOnName?: boolean;

package/dist-lib/lib/tools/skills/catalog.js

@@ -79,6 +79,7 @@ function mergeOverlay(base, overlay) {
     const { origin: _origin, mcpReads: _mcpReads, operations: _operations, ...rest } = overlay;
     return {
         ...rest,
+        displayName: base.displayName,
         credentials: base.credentials,
         allowList: base.allowList,
         platform: base.platform,
@@ -156,6 +157,7 @@ async function loadEntry(skillsDir, dir, origin) {
         const platform = platformsOf(meta.platform, origin);
         return {
             name: dir,
+            displayName: origin === 'overlay' ? undefined : meta.displayName || undefined,
             description: meta.description ?? '',
             aliases: meta.aliases,
             preloadOnName: meta.preloadOnName === false ? false : undefined,

package/dist-lib/lib/tools/skills/frontmatter-parser.d.ts

@@ -1,6 +1,7 @@
 import type { InstallStep, SkillRequires, SkillSetup } from './manifest.ts';
 export interface SkillFrontMatter {
     name?: string;
+    displayName?: string;
     description?: string;
     aliases?: string[];
     preloadOnName?: boolean;

package/dist-lib/lib/tools/skills/frontmatter-parser.js

@@ -1,4 +1,5 @@
 import { parseManifestBlock } from './manifest-parse.js';
+import { isMentionHandle } from './mention-name.js';
 const FRONT_MATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/;
 const FIELD_RE = /^([A-Za-z_][\w-]*):(.*)$/;
 export function parseSkillFrontMatter(raw) {
@@ -54,6 +55,9 @@ function parseFields(block) {
         else if (key === 'name' || key === 'description') {
             meta[key] = stripQuotes(value);
         }
+        else if (key === 'display_name' && isMentionHandle(stripQuotes(value))) {
+            meta.displayName = stripQuotes(value);
+        }
         else if (key === 'preload_on_name') {
             meta.preloadOnName = stripQuotes(value).toLowerCase() !== 'false';
         }

package/dist-lib/lib/tools/skills/mention-name.d.ts

@@ -1 +1,7 @@
 export declare function skillMentionName(text: string): string | null;
+export declare function isMentionHandle(value: string): boolean;
+export interface MentionableSkill {
+    readonly name: string;
+    readonly displayName?: string | undefined;
+}
+export declare function skillMentionHandle(skill: MentionableSkill): string;

package/dist-lib/lib/tools/skills/mention-name.js

@@ -2,3 +2,9 @@ const MENTION_PATTERN = /^@([a-z0-9][a-z0-9_-]*)(?=\s|$)/;
 export function skillMentionName(text) {
     return MENTION_PATTERN.exec(text.trimStart().toLowerCase())?.[1] ?? null;
 }
+export function isMentionHandle(value) {
+    return skillMentionName(`@${value}`) === value.toLowerCase();
+}
+export function skillMentionHandle(skill) {
+    return (skill.displayName ?? skill.name).toLowerCase();
+}

package/dist-lib/lib/tools/skills/mention.d.ts

@@ -1,5 +1,5 @@
 import type { SkillCatalogEntry } from './catalog.ts';
-import { skillMentionName } from './mention-name.ts';
-export { skillMentionName };
+import { skillMentionHandle, skillMentionName } from './mention-name.ts';
+export { skillMentionHandle, skillMentionName };
 export declare function resolveSkillMention(text: string, catalog: readonly SkillCatalogEntry[]): SkillCatalogEntry | null;
 export declare function resolveImplicitSkill(text: string, activeSkills: readonly SkillCatalogEntry[]): SkillCatalogEntry | null;

package/dist-lib/lib/tools/skills/mention.js

@@ -1,12 +1,14 @@
 import { has } from 'asenion';
-import { skillMentionName } from './mention-name.js';
-export { skillMentionName };
+import { skillMentionHandle, skillMentionName } from './mention-name.js';
+export { skillMentionHandle, skillMentionName };
 export function resolveSkillMention(text, catalog) {
     const name = skillMentionName(text);
     if (!name) {
         return null;
     }
-    return catalog.find((skill) => skill.name.toLowerCase() === name) ?? null;
+    return (catalog.find((skill) => skill.displayName?.toLowerCase() === name) ??
+        catalog.find((skill) => !skill.displayName && skill.name.toLowerCase() === name) ??
+        null);
 }
 const MIN_IMPLICIT_NAME_LENGTH = 4;
 function matchesName(text, candidate) {
@@ -16,7 +18,12 @@ function matchesName(text, candidate) {
     }
     return true;
 }
+function withoutMention(text) {
+    const name = skillMentionName(text);
+    return name ? text.trimStart().slice(name.length + 1) : text;
+}
 export function resolveImplicitSkill(text, activeSkills) {
+    const prose = withoutMention(text);
     let best = null;
     let bestLength = 0;
     for (const skill of activeSkills) {
@@ -26,7 +33,7 @@ export function resolveImplicitSkill(text, activeSkills) {
             if (candidate.length < MIN_IMPLICIT_NAME_LENGTH) {
                 continue;
             }
-            if (!matchesName(text, candidate)) {
+            if (!matchesName(prose, candidate)) {
                 continue;
             }
             const weight = candidate.replace(/\+/g, '').length;

package/dist-lib/lib/tools/weather-lookup.js

@@ -32,6 +32,7 @@ export function createWeatherLookupTool({ fetch = noRedirectFetch, resolveHost =
             required: ['location']
         },
         effect: () => 'read',
+        stableRead: true,
         resource: () => ({ kind: 'host', label: `${GEOCODER_HOST}, ${WEATHER_HOST}` }),
         execute: (args, ctx) => execute(args.location, ctx?.signal, { fetch, resolveHost, timeoutMs: geocodeTimeoutMs })
     };

package/dist-lib/lib/tools/web-fetch.js

@@ -43,6 +43,7 @@ export function createWebFetchTool({ fetch: fetchImpl, resolveHost = lookupHost
             required: ['url']
         },
         effect: () => 'read',
+        stableRead: true,
         resource: (args) => {
             try {
                 return { kind: 'host', label: new URL(String(args.url)).hostname };

package/dist-lib/lib/tools/web-search.js

@@ -30,6 +30,7 @@ export function createWebSearchTool({ fetch } = {}) {
             required: ['query']
         },
         effect: () => 'read',
+        stableRead: true,
         async execute(args, ctx) {
             const query = args.query;
             if (typeof query !== 'string' || query.trim().length === 0) {

package/dist-lib/schema/harness.js

@@ -322,7 +322,8 @@ export function registerHarnessTypes(ns) {
             { name: 'surfaceWhenUnsupported', type: 'bool' },
             { name: 'minCapabilityProfile', type: 'string' },
             { name: 'emoji', type: 'string' },
-            { name: 'setupV2', type: '@harness/skill-setup-v2' }
+            { name: 'setupV2', type: '@harness/skill-setup-v2' },
+            { name: 'displayName', type: 'string' }
         ]
     });
     ns.register({

package/dist-lib/spec/hrpc/messages.js

@@ -1,12 +1,12 @@
 // This file is autogenerated by the hyperschema compiler
-// Schema Version: 20
+// Schema Version: 21
 /* eslint-disable camelcase */
 /* eslint-disable quotes */
 /* eslint-disable space-before-function-paren */
 
 import { c } from 'hyperschema/runtime'
 
-const VERSION = 20
+const VERSION = 21
 
 // eslint-disable-next-line no-unused-vars
 let version = VERSION
@@ -1502,7 +1502,8 @@ const encoding28 = {
       (m.surfaceWhenUnsupported ? 256 : 0) |
       (m.minCapabilityProfile ? 512 : 0) |
       (m.emoji ? 1024 : 0) |
-      (m.setupV2 ? 2048 : 0)
+      (m.setupV2 ? 2048 : 0) |
+      ((version >= 21 && m.displayName) ? 4096 : 0)
 
     c.string.preencode(state, m.name)
     c.string.preencode(state, m.description)
@@ -1519,6 +1520,7 @@ const encoding28 = {
     if (m.minCapabilityProfile) c.string.preencode(state, m.minCapabilityProfile)
     if (m.emoji) c.string.preencode(state, m.emoji)
     if (m.setupV2) encoding28_14.preencode(state, m.setupV2)
+    if (version >= 21 && m.displayName) c.string.preencode(state, m.displayName)
   },
   encode(state, m) {
     const flags =
@@ -1533,7 +1535,8 @@ const encoding28 = {
       (m.surfaceWhenUnsupported ? 256 : 0) |
       (m.minCapabilityProfile ? 512 : 0) |
       (m.emoji ? 1024 : 0) |
-      (m.setupV2 ? 2048 : 0)
+      (m.setupV2 ? 2048 : 0) |
+      ((version >= 21 && m.displayName) ? 4096 : 0)
 
     c.string.encode(state, m.name)
     c.string.encode(state, m.description)
@@ -1550,6 +1553,7 @@ const encoding28 = {
     if (m.minCapabilityProfile) c.string.encode(state, m.minCapabilityProfile)
     if (m.emoji) c.string.encode(state, m.emoji)
     if (m.setupV2) encoding28_14.encode(state, m.setupV2)
+    if (version >= 21 && m.displayName) c.string.encode(state, m.displayName)
   },
   decode(state) {
     const r0 = c.string.decode(state)
@@ -1571,7 +1575,8 @@ const encoding28 = {
       surfaceWhenUnsupported: (flags & 256) !== 0,
       minCapabilityProfile: (flags & 512) !== 0 ? c.string.decode(state) : null,
       emoji: (flags & 1024) !== 0 ? c.string.decode(state) : null,
-      setupV2: (flags & 2048) !== 0 ? encoding28_14.decode(state) : null
+      setupV2: (flags & 2048) !== 0 ? encoding28_14.decode(state) : null,
+      displayName: (version >= 21 && (flags & 4096) !== 0) ? c.string.decode(state) : null
     }
   }
 }

package/dist-lib/spec/hyperschema/index.js

@@ -1,12 +1,12 @@
 // This file is autogenerated by the hyperschema compiler
-// Schema Version: 20
+// Schema Version: 21
 /* eslint-disable camelcase */
 /* eslint-disable quotes */
 /* eslint-disable space-before-function-paren */
 
 import { c } from 'hyperschema/runtime'
 
-const VERSION = 20
+const VERSION = 21
 
 // eslint-disable-next-line no-unused-vars
 let version = VERSION
@@ -1502,7 +1502,8 @@ const encoding28 = {
       (m.surfaceWhenUnsupported ? 256 : 0) |
       (m.minCapabilityProfile ? 512 : 0) |
       (m.emoji ? 1024 : 0) |
-      (m.setupV2 ? 2048 : 0)
+      (m.setupV2 ? 2048 : 0) |
+      ((version >= 21 && m.displayName) ? 4096 : 0)
 
     c.string.preencode(state, m.name)
     c.string.preencode(state, m.description)
@@ -1519,6 +1520,7 @@ const encoding28 = {
     if (m.minCapabilityProfile) c.string.preencode(state, m.minCapabilityProfile)
     if (m.emoji) c.string.preencode(state, m.emoji)
     if (m.setupV2) encoding28_14.preencode(state, m.setupV2)
+    if (version >= 21 && m.displayName) c.string.preencode(state, m.displayName)
   },
   encode(state, m) {
     const flags =
@@ -1533,7 +1535,8 @@ const encoding28 = {
       (m.surfaceWhenUnsupported ? 256 : 0) |
       (m.minCapabilityProfile ? 512 : 0) |
       (m.emoji ? 1024 : 0) |
-      (m.setupV2 ? 2048 : 0)
+      (m.setupV2 ? 2048 : 0) |
+      ((version >= 21 && m.displayName) ? 4096 : 0)
 
     c.string.encode(state, m.name)
     c.string.encode(state, m.description)
@@ -1550,6 +1553,7 @@ const encoding28 = {
     if (m.minCapabilityProfile) c.string.encode(state, m.minCapabilityProfile)
     if (m.emoji) c.string.encode(state, m.emoji)
     if (m.setupV2) encoding28_14.encode(state, m.setupV2)
+    if (version >= 21 && m.displayName) c.string.encode(state, m.displayName)
   },
   decode(state) {
     const r0 = c.string.decode(state)
@@ -1571,7 +1575,8 @@ const encoding28 = {
       surfaceWhenUnsupported: (flags & 256) !== 0,
       minCapabilityProfile: (flags & 512) !== 0 ? c.string.decode(state) : null,
       emoji: (flags & 1024) !== 0 ? c.string.decode(state) : null,
-      setupV2: (flags & 2048) !== 0 ? encoding28_14.decode(state) : null
+      setupV2: (flags & 2048) !== 0 ? encoding28_14.decode(state) : null,
+      displayName: (version >= 21 && (flags & 4096) !== 0) ? c.string.decode(state) : null
     }
   }
 }

package/dist-lib/spec/hyperschema/schema.json

@@ -1,5 +1,5 @@
 {
-  "version": 20,
+  "version": 21,
   "schema": [
     {
       "name": "empty",
@@ -1246,6 +1246,11 @@
           "name": "setupV2",
           "type": "@harness/skill-setup-v2",
           "version": 1
+        },
+        {
+          "name": "displayName",
+          "type": "string",
+          "version": 21
         }
       ]
     },

package/dist-lib/spec/hyperschema/types.d.ts

@@ -1,5 +1,5 @@
 // This file is autogenerated by hyperschema-ts
-// Schema version: 20
+// Schema version: 21
 // Do not edit manually.
 
 export interface HarnessEmpty {
@@ -235,6 +235,7 @@ export interface HarnessSkill {
   minCapabilityProfile?: string | null
   emoji?: string | null
   setupV2?: HarnessSkillSetupV2 | null
+  displayName?: string | null
 }
 
 export interface HarnessSkillRequest {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qvac/harness",
-  "version": "0.8.7",
+  "version": "0.8.9",
   "type": "module",
   "engines": {
     "bare": ">=1.34.0"
@@ -747,7 +747,7 @@
     "@qvac/inference": "0.21.0",
     "@qvac/langdetect-text": "0.1.2",
     "@qvac/sdk": "0.21.0",
-    "@qvac/skills": "0.1.14",
+    "@qvac/skills": "0.1.15",
     "@xmldom/xmldom": "^0.9.12",
     "asenion": "^0.1.0",
     "b4a": "^1.9.0",