@qvac/harness 0.8.6 → 0.8.7

package/dist-lib/lib/tools/exec.d.ts

@@ -14,6 +14,7 @@ export interface ExecToolOptions {
     readonly pythonNetwork?: boolean;
     readonly credentialStore?: CredentialStoreFn;
     readonly skillSettings?: SkillSettingsFn;
+    readonly skillEnv?: SkillEnvFn;
     readonly realpath?: Realpath;
     readonly deniedRoots?: readonly string[];
     readonly skillsDir?: string;
@@ -23,4 +24,6 @@ export interface ScriptRun {
     trusted: boolean;
 }
 export declare function resolveScriptRun(rawArgs: Record<string, unknown>, skillsDir: string | undefined): ScriptRun | ExecError | null;
-export declare function createExecTool({ spawn, killProcess, loadPyodide, disablePyodide, pythonNetwork, credentialStore, skillSettings, realpath, deniedRoots, skillsDir }?: ExecToolOptions): ToolDefinition;
+export type SkillEnvFn = (skill: string) => Readonly<Record<string, string>> | undefined;
+export declare function declaredEnv(declared: Readonly<Record<string, string>> | undefined, session: string | undefined): Record<string, string>;
+export declare function createExecTool({ spawn, killProcess, loadPyodide, disablePyodide, pythonNetwork, credentialStore, skillSettings, skillEnv, realpath, deniedRoots, skillsDir }?: ExecToolOptions): ToolDefinition;

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

@@ -6,7 +6,7 @@ import { namedHosts } from './exec/adapters/python/named-hosts.js';
 import { pythonReachesNetwork } from './exec/adapters/python/net-shim.js';
 import { createShellAdapter } from './exec/adapters/shell/shell-adapter.js';
 import { routeObsidianCommand } from './exec/obsidian/route.js';
-import { MAX_OUTPUT_CHARS_LIMIT } from './exec/runner.js';
+import { MAX_OUTPUT_CHARS, MAX_OUTPUT_CHARS_LIMIT, TRUNCATED_OUTPUT_SUFFIX } from './exec/runner.js';
 import { bareBin, firstCommandToken, sanitizeCommand } from './exec/scope.js';
 import { FILES_NEED_PYTHON_ERROR, isPythonSourceShaped, PACKAGES_NEED_PYTHON_ERROR, pythonRedirectError, startsLikePython, videoToolError } from './exec/shell-guidance.js';
 import { shellArgv } from './exec/shell-argv.js';
@@ -47,6 +47,30 @@ function shellEffect(command, toolOps) {
     }
     return matched.every((op) => op.annotation(argv) === 'read') ? 'read' : 'write';
 }
+function shellOutputCap(command, toolOps) {
+    const { ops, argv } = resolveShellOps(command, toolOps);
+    const caps = ops.map((op) => op.outputCap(argv)).filter((cap) => cap !== undefined);
+    return caps.length > 0 ? Math.min(...caps) : undefined;
+}
+function noteCeiling(result, ceiling) {
+    if (!result || typeof result !== 'object')
+        return result;
+    const out = { ...result };
+    for (const stream of ['stdout', 'stderr']) {
+        const text = out[stream];
+        if (typeof text === 'string' && text.endsWith(TRUNCATED_OUTPUT_SUFFIX)) {
+            out[stream] =
+                text.slice(0, -TRUNCATED_OUTPUT_SUFFIX.length) +
+                    `… [truncated at this skill's ${ceiling}-character limit for this command; a larger maxOutputChars does not apply]`;
+        }
+    }
+    return out;
+}
+function cappedOutput(requested, ceiling) {
+    if (ceiling === undefined)
+        return requested;
+    return Math.min(requested ?? MAX_OUTPUT_CHARS, ceiling);
+}
 function resolveExecution({ adapters, fallback }, args, ctx) {
     for (const adapter of adapters) {
         const plan = adapter.resolve(args, ctx);
@@ -289,18 +313,33 @@ function checkExecutionScope(args, { toolOps, disablePyodide, sandbox, network }
     }
     return checkShellScope(command, toolOps);
 }
-async function skillsEnv(skillSettings, ctx) {
+async function skillsEnv(skillSettings, skillEnv, ctx) {
     const skills = ctx?.skills ?? [];
     if (skills.length === 0) {
         return undefined;
     }
     const env = {};
     for (const skill of skills) {
-        Object.assign(env, settingsEnv(skill, await skillSettings(skill, ctx?.agentId)));
+        if (skillSettings) {
+            Object.assign(env, settingsEnv(skill, await skillSettings(skill, ctx?.agentId)));
+        }
+        Object.assign(env, declaredEnv(skillEnv?.(skill), ctx?.session));
     }
     return Object.keys(env).length > 0 ? env : undefined;
 }
-export function createExecTool({ spawn, killProcess, loadPyodide, disablePyodide = false, pythonNetwork = !disablePyodide && pythonReachesNetwork(), credentialStore, skillSettings, realpath = defaultRealpath, deniedRoots, skillsDir } = {}) {
+export function declaredEnv(declared, session) {
+    const env = {};
+    for (const [name, value] of Object.entries(declared ?? {})) {
+        if (!value.includes('${session}')) {
+            env[name] = value;
+        }
+        else if (session) {
+            env[name] = value.replaceAll('${session}', session);
+        }
+    }
+    return env;
+}
+export function createExecTool({ spawn, killProcess, loadPyodide, disablePyodide = false, pythonNetwork = !disablePyodide && pythonReachesNetwork(), credentialStore, skillSettings, skillEnv, realpath = defaultRealpath, deniedRoots, skillsDir } = {}) {
     const adapters = [createPythonAdapter(disablePyodide, loadPyodide, pythonNetwork)];
     const fallback = createShellAdapter({ spawn, killProcess, loadRuntime: bareRuntime });
     return {
@@ -349,7 +388,7 @@ export function createExecTool({ spawn, killProcess, loadPyodide, disablePyodide
                 },
                 maxOutputChars: {
                     type: 'number',
-                    description: 'Optional stdout/stderr cap in characters (default 8192, max 65536). Raise when reading long content, e.g. a full note.'
+                    description: 'Optional stdout/stderr cap in characters (default 8192, max 65536). Raise when reading long content, e.g. a full note. A skill may cap one of its commands lower; the truncation note says so, and raising this does not lift that cap.'
                 },
                 script: {
                     type: 'string',
@@ -564,10 +603,12 @@ export function createExecTool({ spawn, killProcess, loadPyodide, disablePyodide
                     timeout = Math.min(timeout, remaining);
                 }
             }
-            const maxOutputChars = parsePositiveInt(rawArgs.maxOutputChars, 'maxOutputChars', MAX_OUTPUT_CHARS_LIMIT);
-            if (maxOutputChars && typeof maxOutputChars === 'object') {
-                return maxOutputChars;
+            const requestedCap = parsePositiveInt(rawArgs.maxOutputChars, 'maxOutputChars', MAX_OUTPUT_CHARS_LIMIT);
+            if (requestedCap && typeof requestedCap === 'object') {
+                return requestedCap;
             }
+            const ceiling = shellOutputCap(command, ctx?.toolOps);
+            const maxOutputChars = cappedOutput(requestedCap, ceiling);
             if (!isPythonLanguage(rawArgs.language)) {
                 const obsidian = await routeObsidianCommand(command, ctx, {
                     credentialStore,
@@ -581,7 +622,7 @@ export function createExecTool({ spawn, killProcess, loadPyodide, disablePyodide
                     return obsidian;
                 }
             }
-            const skillEnv = skillSettings ? await skillsEnv(skillSettings, ctx) : undefined;
+            const childEnv = await skillsEnv(skillSettings, skillEnv, ctx);
             try {
                 const execution = resolveExecution({ adapters, fallback }, rawArgs, {
                     attach: ctx?.attach,
@@ -593,13 +634,16 @@ export function createExecTool({ spawn, killProcess, loadPyodide, disablePyodide
                     approval: ctx?.approval,
                     confirmConnect: ctx?.askUser ? connectAsker(ctx.askUser) : undefined
                 });
-                return await execution.run({
+                const result = await execution.run({
                     cwd,
                     timeoutMs: timeout,
                     maxOutputChars,
                     signal: ctx?.signal,
-                    env: skillEnv
+                    env: childEnv
                 });
+                return ceiling !== undefined && maxOutputChars === ceiling
+                    ? noteCeiling(result, ceiling)
+                    : result;
             }
             catch (err) {
                 const error = err instanceof Error ? err : new Error(String(err));

package/dist-lib/lib/tools/office/ops.js

@@ -7,7 +7,7 @@ export const PPTX_OPS = {
     setText: { slots: [['slide', 'shape'], 'text'] },
     setCellText: { slots: [['slide', 'shape', 'row', 'column'], 'text'] },
     setStyle: { slots: [['slide', 'shape'], 'style', ['paragraph']] },
-    addSlide: { slots: [['like', 'layout', 'at', 'title', 'body']] },
+    addSlide: { slots: [['like', 'layout', 'at', 'title', 'body', 'image']] },
     addPicture: { slots: ['slide', 'image', [...BOX, 'name', 'description']], inches: true },
     addTextBox: { slots: ['slide', [...BOX, 'text', 'style', 'fill', 'name']], inches: true },
     addTable: { slots: ['slide', [...BOX, 'rows', 'header', 'name']], inches: true },

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

@@ -1,12 +1,13 @@
 import b4a from 'b4a';
 import { errorMessage, isRecord } from '../guards.js';
-import { docx, pptx, units, xlsx } from '../office/engine/index.js';
+import { DocsError, docx, pptx, units, xlsx } from '../office/engine/index.js';
 import { stageInputs } from './exec/adapters/python/attachments.js';
 import { checkOutputBytes, RUN_OUTPUT_BUDGET_BYTES } from './exec/adapters/python/output-policy.js';
 import { DOCX_OPS, opArguments, opKeys, PPTX_OPS, withAliases, XLSX_OPS } from './office/ops.js';
 const READ_CELL_LIMIT = 10_000;
 const attachedThisTurn = new WeakMap();
 const FIRST_SHEET = /^sheet ?1$/i;
+const NEW_DECK_HINT = '; a new deck has only the slides its addSlide ops make, slides count from 0, and an op on a slide goes after the addSlide that makes it';
 const SHAPE_ROLES = new Set(['title', 'subtitle', 'body']);
 const HOISTED = ['attachmentId', 'output'];
 const WHERE_IDS_ARE = 'copy the id from the [Attached file "…" — attachmentId: …] line or an earlier tool result';
@@ -25,6 +26,9 @@ export function shapeFor(deck, op) {
     const found = deck.read()[slide]?.shapes.find((entry) => entry.name.toLowerCase() === wanted);
     return found && found.id !== null ? { ...op, shape: found.id } : op;
 }
+function newDeckHint(err, created) {
+    return created && err instanceof DocsError && err.code === 'SLIDE_NOT_FOUND' ? NEW_DECK_HINT : '';
+}
 export function sheetFor(book, op, created) {
     if (typeof op.sheet !== 'string')
         return op;
@@ -70,7 +74,8 @@ const PPTX_FORMAT = {
     create: (options) => pptx.create(options),
     read: (deck) => deck.read(),
     count: (deck) => ({ slides: deck.slideCount }),
-    prepare: (deck, op) => shapeFor(deck, op)
+    prepare: (deck, op) => shapeFor(deck, op),
+    hint: newDeckHint
 };
 const DOCX_FORMAT = {
     name: 'docx',
@@ -141,7 +146,11 @@ function parseOp(format, op, i) {
         return `ops[${i}] sheets lists the sheets and takes no arguments; to add a sheet use { op: "addSheet", name }`;
     }
     const takes = keys.length ? `it takes ${keys.join(', ')}` : 'it takes no arguments';
-    return `ops[${i}] ${op.op} does not take ${unknown.join(', ')}; ${takes}`;
+    const nested = unknown.filter((key) => format.ops[key]);
+    const apart = nested.length
+        ? `; ${nested.map((name) => `{ "op": "${name}", ... }`).join(' and ')} goes in ops as its own entry, next to this one, not inside it`
+        : '';
+    return `ops[${i}] ${op.op} does not take ${unknown.join(', ')}; ${takes}${apart}`;
 }
 function parseOps(format, ops) {
     if (!Array.isArray(ops)) {
@@ -252,8 +261,11 @@ async function imageInput(op, i, ctx) {
     }
     return { attachmentId: id ? await imageId(ctx, id) : undefined, path: `image-${i}.png` };
 }
+function takesImage(op) {
+    return op.spec.slots.includes('image') || op.args.image !== undefined;
+}
 async function stagedImages(request, ctx) {
-    const wanted = request.ops.flatMap((op, i) => (opKeys(op.spec).includes('image') ? [i] : []));
+    const wanted = request.ops.flatMap((op, i) => (takesImage(op) ? [i] : []));
     const images = new Map();
     if (!wanted.length) {
         return images;
@@ -358,7 +370,8 @@ function runOps({ format, document, request, images }) {
             results.push(runOp(document, op, input));
         }
         catch (err) {
-            return { error: `ops[${i}] ${op.name}: ${errorMessage(err)}` };
+            const hint = format.hint?.(err, created) ?? '';
+            return { error: `ops[${i}] ${op.name}: ${errorMessage(err)}${hint}` };
         }
     }
     return results;
@@ -452,6 +465,7 @@ async function execute(format, args, ctx) {
     const renamed = output !== request.output
         ? `Saved as ${output}, so the attached ${fileName} keeps its own name. `
         : '';
+    const unplaced = !!ctx.turnImages?.length && !images.size;
     return {
         results,
         attachments: [attachment],
@@ -459,9 +473,18 @@ async function execute(format, args, ctx) {
         reply: `${attachment.fileName} — ${countLine(counts)}`,
         next: renamed +
             `Done: ${attachment.fileName} ${repeated ? 'was already' : 'is'} attached to the chat and shown to the user. ` +
-            `Do not call ${format.name} again for it. Your answer is the reply value alone, word for word.`
+            afterSave(format, attachment.attachmentId, unplaced)
     };
 }
+function afterSave(format, attachmentId, unplaced) {
+    const reply = 'Your answer is the reply value alone, word for word.';
+    if (!unplaced) {
+        return `Do not call ${format.name} again for it. ${reply}`;
+    }
+    return (`The image the user attached to their message is not in it. If they asked for that image in the ${format.noun}, ` +
+        `call ${format.name} once more with attachmentId "${attachmentId}" and one op that adds it with "image": {}. ` +
+        `Otherwise: ${reply}`);
+}
 function createOfficeTool(format) {
     return {
         name: format.name,

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

@@ -20,6 +20,7 @@ export interface SkillCatalogEntry {
     requires?: SkillRequires;
     install?: InstallStep[];
     setup?: SkillSetup;
+    env?: Readonly<Record<string, string>>;
     cliValidator?: CliValidator;
     stub?: boolean;
     minCapabilityProfile?: string;

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

@@ -82,6 +82,7 @@ function mergeOverlay(base, overlay) {
         credentials: base.credentials,
         allowList: base.allowList,
         platform: base.platform,
+        env: base.env,
         operations: base.operations,
         mcpReads: base.mcpReads
     };
@@ -166,6 +167,7 @@ async function loadEntry(skillsDir, dir, origin) {
             requires: meta.requires,
             install: meta.install,
             setup: meta.setup,
+            env: origin === 'overlay' ? undefined : meta.env,
             cliValidator: cli ? buildCliValidator(cli) : undefined,
             stub: meta.stub,
             minCapabilityProfile: meta.minCapabilityProfile || undefined,

package/dist-lib/lib/tools/skills/cli-schema-check.d.ts

@@ -1,3 +1,4 @@
 import type { JsonSchema } from './cli-schema-types.ts';
 export declare function buildSchemaAnnotation(schema: JsonSchema): (argv: readonly string[]) => 'read' | 'write';
+export declare function buildSchemaOutputCap(schema: JsonSchema): (argv: readonly string[]) => number | undefined;
 export declare function buildSchemaCheck(schema: JsonSchema, resourcePaths: readonly string[] | undefined): (argv: readonly string[]) => string | null;

package/dist-lib/lib/tools/skills/cli-schema-check.js

@@ -13,6 +13,9 @@ export function buildSchemaAnnotation(schema) {
         return walkCommands(argv, schema).node['x-effect'] === 'read' ? 'read' : 'write';
     };
 }
+export function buildSchemaOutputCap(schema) {
+    return (argv) => walkCommands(argv, schema).node['x-max-output-chars'];
+}
 function basename(p) {
     return p.slice(Math.max(p.lastIndexOf('/'), p.lastIndexOf('\\')) + 1);
 }

package/dist-lib/lib/tools/skills/cli-schema-load.js

@@ -28,6 +28,9 @@ export async function resolveCliSchema(skillDir, bin, readFile = (p) => fs.promi
         if (!resourceEffectsValid(schema)) {
             return { bin, schemaFile: CLI_SCHEMA_FILENAME };
         }
+        if (!outputCapsValid(schema)) {
+            return { bin, schemaFile: CLI_SCHEMA_FILENAME };
+        }
         const resourcePaths = resolveResourcePaths(skillDir, schema);
         return {
             bin,
@@ -63,6 +66,13 @@ function resourceEffectsValid(schema) {
     const files = new Set(schema['x-resource-files'] ?? []);
     return Object.entries(effects).every(([file, effect]) => effect === 'read' && files.has(file));
 }
+function outputCapsValid(schema) {
+    const cap = schema['x-max-output-chars'];
+    if (cap !== undefined && !(Number.isInteger(cap) && cap > 0)) {
+        return false;
+    }
+    return Object.values(schema.properties ?? {}).every(outputCapsValid);
+}
 function resolveResourcePaths(skillDir, schema) {
     const resources = schema['x-resource-files'] ?? [];
     return resources

package/dist-lib/lib/tools/skills/cli-schema-types.d.ts

@@ -13,6 +13,7 @@ export interface JsonSchema {
     readonly 'x-resource-files'?: readonly string[];
     readonly 'x-resource-effects'?: Readonly<Record<string, string>>;
     readonly 'x-effect'?: string;
+    readonly 'x-max-output-chars'?: number;
     readonly [key: string]: unknown;
 }
 export interface SkillCli {
@@ -27,4 +28,5 @@ export interface CliValidator {
     readonly check: (argv: readonly string[]) => string | null;
     readonly annotation: (argv: readonly string[]) => 'read' | 'write';
     readonly effect: (argv: readonly string[]) => 'read' | 'write';
+    readonly outputCap: (argv: readonly string[]) => number | undefined;
 }

package/dist-lib/lib/tools/skills/cli-schema.js

@@ -1,7 +1,7 @@
 export { CLI_SCHEMA_FILENAME } from './cli-schema-types.js';
 export { argvToObject } from './cli-argv.js';
 export { loadSkillCli, resolveCliSchema, execBinFromTools } from './cli-schema-load.js';
-import { buildSchemaAnnotation, buildSchemaCheck } from './cli-schema-check.js';
+import { buildSchemaAnnotation, buildSchemaCheck, buildSchemaOutputCap } from './cli-schema-check.js';
 export function buildCliValidator(def) {
     const bin = def.bin.toLowerCase();
     if (!def.schema) {
@@ -9,16 +9,19 @@ export function buildCliValidator(def) {
             bin,
             check: () => 'skill cli schema is missing',
             annotation: () => 'write',
-            effect: () => 'write'
+            effect: () => 'write',
+            outputCap: () => undefined
         };
     }
     const check = buildSchemaCheck(def.schema, def.resourcePaths);
     const annotation = buildSchemaAnnotation(def.schema);
+    const outputCap = buildSchemaOutputCap(def.schema);
     return {
         bin,
         check,
         annotation,
-        effect: (argv) => (check(argv) === null ? annotation(argv) : 'write')
+        effect: (argv) => (check(argv) === null ? annotation(argv) : 'write'),
+        outputCap: (argv) => (check(argv) === null ? outputCap(argv) : undefined)
     };
 }
 export function checkCliOps(argv, compiled) {

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

@@ -12,6 +12,7 @@ export interface SkillFrontMatter {
     requires?: SkillRequires;
     install?: InstallStep[];
     setup?: SkillSetup;
+    env?: Readonly<Record<string, string>>;
     stub?: boolean;
     minCapabilityProfile?: string;
     emoji?: string;

package/dist-lib/lib/tools/skills/manifest-parse.d.ts

@@ -3,6 +3,7 @@ export interface ParsedManifest {
     requires?: SkillRequires;
     install?: InstallStep[];
     setup?: SkillSetup;
+    env?: Readonly<Record<string, string>>;
     stub?: boolean;
     minCapabilityProfile?: string;
     emoji?: string;

package/dist-lib/lib/tools/skills/manifest-parse.js

@@ -12,11 +12,23 @@ export function parseManifestBlock(block, key = 'metadata') {
         requires,
         install,
         setup,
+        env: readEnv(oc.env),
         stub: typeof oc.stub === 'boolean' ? oc.stub : undefined,
         minCapabilityProfile: typeof oc.minCapabilityProfile === 'string' ? oc.minCapabilityProfile : undefined,
         emoji: typeof oc.emoji === 'string' ? oc.emoji : undefined
     };
 }
+function readEnv(v) {
+    if (!isObj(v))
+        return undefined;
+    const env = {};
+    for (const [name, value] of Object.entries(v)) {
+        if (typeof value === 'string' && /^[A-Z_][A-Z0-9_]*$/.test(name)) {
+            env[name] = value;
+        }
+    }
+    return Object.keys(env).length > 0 ? env : undefined;
+}
 function extractJsonBlock(block, key) {
     const at = block.indexOf(`${key}:`);
     if (at === -1) {

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

@@ -3,4 +3,3 @@ import { skillMentionName } from './mention-name.ts';
 export { skillMentionName };
 export declare function resolveSkillMention(text: string, catalog: readonly SkillCatalogEntry[]): SkillCatalogEntry | null;
 export declare function resolveImplicitSkill(text: string, activeSkills: readonly SkillCatalogEntry[]): SkillCatalogEntry | null;
-export declare function skillPreloadMessage(content: string, name: string, body: string): string;

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

@@ -38,6 +38,3 @@ export function resolveImplicitSkill(text, activeSkills) {
     }
     return best;
 }
-export function skillPreloadMessage(content, name, body) {
-    return `[Skill invoked by user: ${name}]\n${body}\n\nThe user's message:\n${content}`;
-}

package/dist-lib/schema/harness.js

@@ -113,7 +113,8 @@ export function registerHarnessTypes(ns) {
             { name: 'captureInferenceCalls', type: 'bool' },
             { name: 'capability', type: 'string' },
             { name: 'arguments', type: 'json' },
-            { name: 'enhance', type: 'string' }
+            { name: 'enhance', type: 'string' },
+            { name: 'session', 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: 19
+// Schema Version: 20
 /* eslint-disable camelcase */
 /* eslint-disable quotes */
 /* eslint-disable space-before-function-paren */
 
 import { c } from 'hyperschema/runtime'
 
-const VERSION = 19
+const VERSION = 20
 
 // eslint-disable-next-line no-unused-vars
 let version = VERSION
@@ -491,7 +491,8 @@ const encoding11 = {
       ((version >= 9 && m.captureInferenceCalls) ? 33554432 : 0) |
       ((version >= 11 && m.capability) ? 67108864 : 0) |
       ((version >= 11 && m.arguments) ? 134217728 : 0) |
-      ((version >= 12 && m.enhance) ? 268435456 : 0)
+      ((version >= 12 && m.enhance) ? 268435456 : 0) |
+      ((version >= 20 && m.session) ? 536870912 : 0)
 
     encoding10.preencode(state, m.type)
     c.uint.preencode(state, flags)
@@ -522,6 +523,7 @@ const encoding11 = {
     if (version >= 11 && m.capability) c.string.preencode(state, m.capability)
     if (version >= 11 && m.arguments) c.json.preencode(state, m.arguments)
     if (version >= 12 && m.enhance) c.string.preencode(state, m.enhance)
+    if (version >= 20 && m.session) c.string.preencode(state, m.session)
   },
   encode(state, m) {
     const flags =
@@ -553,7 +555,8 @@ const encoding11 = {
       ((version >= 9 && m.captureInferenceCalls) ? 33554432 : 0) |
       ((version >= 11 && m.capability) ? 67108864 : 0) |
       ((version >= 11 && m.arguments) ? 134217728 : 0) |
-      ((version >= 12 && m.enhance) ? 268435456 : 0)
+      ((version >= 12 && m.enhance) ? 268435456 : 0) |
+      ((version >= 20 && m.session) ? 536870912 : 0)
 
     encoding10.encode(state, m.type)
     c.uint.encode(state, flags)
@@ -584,6 +587,7 @@ const encoding11 = {
     if (version >= 11 && m.capability) c.string.encode(state, m.capability)
     if (version >= 11 && m.arguments) c.json.encode(state, m.arguments)
     if (version >= 12 && m.enhance) c.string.encode(state, m.enhance)
+    if (version >= 20 && m.session) c.string.encode(state, m.session)
   },
   decode(state) {
     const r0 = encoding10.decode(state)
@@ -619,7 +623,8 @@ const encoding11 = {
       captureInferenceCalls: (version >= 9 && (flags & 33554432) !== 0),
       capability: (version >= 11 && (flags & 67108864) !== 0) ? c.string.decode(state) : null,
       arguments: (version >= 11 && (flags & 134217728) !== 0) ? c.json.decode(state) : null,
-      enhance: (version >= 12 && (flags & 268435456) !== 0) ? c.string.decode(state) : null
+      enhance: (version >= 12 && (flags & 268435456) !== 0) ? c.string.decode(state) : null,
+      session: (version >= 20 && (flags & 536870912) !== 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: 19
+// Schema Version: 20
 /* eslint-disable camelcase */
 /* eslint-disable quotes */
 /* eslint-disable space-before-function-paren */
 
 import { c } from 'hyperschema/runtime'
 
-const VERSION = 19
+const VERSION = 20
 
 // eslint-disable-next-line no-unused-vars
 let version = VERSION
@@ -491,7 +491,8 @@ const encoding11 = {
       ((version >= 9 && m.captureInferenceCalls) ? 33554432 : 0) |
       ((version >= 11 && m.capability) ? 67108864 : 0) |
       ((version >= 11 && m.arguments) ? 134217728 : 0) |
-      ((version >= 12 && m.enhance) ? 268435456 : 0)
+      ((version >= 12 && m.enhance) ? 268435456 : 0) |
+      ((version >= 20 && m.session) ? 536870912 : 0)
 
     encoding10.preencode(state, m.type)
     c.uint.preencode(state, flags)
@@ -522,6 +523,7 @@ const encoding11 = {
     if (version >= 11 && m.capability) c.string.preencode(state, m.capability)
     if (version >= 11 && m.arguments) c.json.preencode(state, m.arguments)
     if (version >= 12 && m.enhance) c.string.preencode(state, m.enhance)
+    if (version >= 20 && m.session) c.string.preencode(state, m.session)
   },
   encode(state, m) {
     const flags =
@@ -553,7 +555,8 @@ const encoding11 = {
       ((version >= 9 && m.captureInferenceCalls) ? 33554432 : 0) |
       ((version >= 11 && m.capability) ? 67108864 : 0) |
       ((version >= 11 && m.arguments) ? 134217728 : 0) |
-      ((version >= 12 && m.enhance) ? 268435456 : 0)
+      ((version >= 12 && m.enhance) ? 268435456 : 0) |
+      ((version >= 20 && m.session) ? 536870912 : 0)
 
     encoding10.encode(state, m.type)
     c.uint.encode(state, flags)
@@ -584,6 +587,7 @@ const encoding11 = {
     if (version >= 11 && m.capability) c.string.encode(state, m.capability)
     if (version >= 11 && m.arguments) c.json.encode(state, m.arguments)
     if (version >= 12 && m.enhance) c.string.encode(state, m.enhance)
+    if (version >= 20 && m.session) c.string.encode(state, m.session)
   },
   decode(state) {
     const r0 = encoding10.decode(state)
@@ -619,7 +623,8 @@ const encoding11 = {
       captureInferenceCalls: (version >= 9 && (flags & 33554432) !== 0),
       capability: (version >= 11 && (flags & 67108864) !== 0) ? c.string.decode(state) : null,
       arguments: (version >= 11 && (flags & 134217728) !== 0) ? c.json.decode(state) : null,
-      enhance: (version >= 12 && (flags & 268435456) !== 0) ? c.string.decode(state) : null
+      enhance: (version >= 12 && (flags & 268435456) !== 0) ? c.string.decode(state) : null,
+      session: (version >= 20 && (flags & 536870912) !== 0) ? c.string.decode(state) : null
     }
   }
 }

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

@@ -1,5 +1,5 @@
 {
-  "version": 19,
+  "version": 20,
   "schema": [
     {
       "name": "empty",
@@ -475,6 +475,11 @@
           "name": "enhance",
           "type": "string",
           "version": 12
+        },
+        {
+          "name": "session",
+          "type": "string",
+          "version": 20
         }
       ]
     },

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

@@ -1,5 +1,5 @@
 // This file is autogenerated by hyperschema-ts
-// Schema version: 19
+// Schema version: 20
 // Do not edit manually.
 
 export interface HarnessEmpty {
@@ -91,6 +91,7 @@ export interface HarnessCompletionFrame {
   capability?: string | null
   arguments?: unknown | null
   enhance?: string | null
+  session?: string | null
 }
 
 export type HarnessCompletionEventType = "content" | "thinking" | "tool-call" | "tool-result" | "approval-ask" | "metrics" | "error" | "aborted" | "attach-ask" | "fetch-ask" | "progress" | "rag-ask" | "question-ask" | "done" | "tool-activity" | "drive-ask" | "inference-call" | "inference-sent"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qvac/harness",
-  "version": "0.8.6",
+  "version": "0.8.7",
   "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.12",
+    "@qvac/skills": "0.1.14",
     "@xmldom/xmldom": "^0.9.12",
     "asenion": "^0.1.0",
     "b4a": "^1.9.0",
@@ -773,7 +773,7 @@
     "bare-process": "4.4.1",
     "bare-sidecar": "0.5.7",
     "bare-storage": "^1.1.0",
-    "bare-stow": "^0.1.4",
+    "bare-stow": "^0.1.7",
     "bare-stream": "^2.13.3",
     "bare-subprocess": "^6.1.0",
     "bare-supervisor": "^0.1.1",
@@ -809,8 +809,8 @@
     "holepunch-types": "^0.2.1",
     "hyperdrive": "^13.3.3",
     "jsdom": "~30.0.1",
-    "lunte": "^1.8.4",
-    "lunte-plugin-qvac": "^0.1.0",
+    "lunte": "^1.8.6",
+    "lunte-plugin-qvac": "^0.2.0",
     "mermaid": "~11.16.1",
     "prettier": "^3.6.2",
     "prettier-config-holepunch": "^2.0.0",
@@ -819,8 +819,6 @@
   "patchedDependencies": {
     "pyodide@314.0.2": "patches/pyodide@314.0.2.patch",
     "localwatch@1.4.3": "patches/localwatch@1.4.3.patch",
-    "hypercore-blob-server@1.15.0": "patches/hypercore-blob-server@1.15.0.patch",
-    "bare-stow@0.1.5": "patches/bare-stow@0.1.5.patch",
     "@qvac/inference@0.21.0": "patches/@qvac%2Finference@0.21.0.patch"
   },
   "repository": {

package/worker/harness-sidecar.mjs

@@ -124,7 +124,8 @@ export default async function start(ipc, ready) {
       ...credentialed,
       deniedRoots,
       skillsDir,
-      skillSettings: (skill, agentId) => harness?.skillSettings(skill, agentId) ?? {}
+      skillSettings: (skill, agentId) => harness?.skillSettings(skill, agentId) ?? {},
+      skillEnv: (skill) => skillCatalog?.find((entry) => entry.name === skill)?.env
     }),
     mcpCallTool,
     createWebSearchTool(),