mu-harness 0.17.1 → 0.17.2

package/esm/harness/create.js

@@ -1,3 +1,4 @@
+import os from 'node:os';
 import { join } from 'node:path';
 import process from 'node:process';
 import { createAgentRegistry, grantArg, loadAgents, toolDecision, toolNames } from '../agents/index.js';
@@ -10,6 +11,7 @@ import { createScheduler, createScheduleTaskTool, createTasksCommand, createTask
 import { createAgentSession, createSessionCatalog, createSessionManager, createSessionStore, persistTo, runTitler, } from '../session/index.js';
 import { createRunSkillTool, createSkillRegistry, createSkillTool, createSkillWriterTool, loadSkills, runSkill, } from '../skills/index.js';
 import { createSubAgentRegistry, createSubAgentTool, runSubAgent } from '../subAgents/index.js';
+import { environmentBlock } from './environment.js';
 import { createModelRegistry } from './models.js';
 const TITLE_AGENT = {
     name: 'title',
@@ -22,13 +24,27 @@ export const createHarness = async (options) => {
     const cwd = options.cwd ?? process.cwd();
     const config = createHarnessConfig({ hostName, xdg });
     const models = createModelRegistry({ providers, default: model });
-    const plugins = createPluginStore({ dir: join(config.configDir, 'plugins') });
+    const pluginsDir = join(config.configDir, 'plugins');
+    const agentsDir = join(config.configDir, 'agents');
+    const plugins = createPluginStore({ dir: pluginsDir });
     const newId = () => crypto.randomUUID();
     const pluginAgents = (sessionDefaults.plugins ?? []).flatMap((plugin) => plugin.agents ?? []);
-    const diskAgents = await loadAgents(join(config.configDir, 'agents'));
+    const diskAgents = await loadAgents(agentsDir);
     const agents = createAgentRegistry([...hostAgents, ...pluginAgents, ...diskAgents]);
     const skillsDir = join(config.configDir, 'skills');
     const cwdSkillsDir = join(cwd, 'skills');
+    const envBlock = environmentBlock({
+        os: `${os.platform()} ${os.release()} (${os.arch()})`,
+        configDir: config.configDir,
+        pluginsDir,
+        skillsDir,
+        agentsDir,
+        hostName,
+        hostSourceUrl: options.sourceUrl,
+    });
+    const envHook = {
+        prepareRequest: ({ system }) => ({ system: system ? `${system}\n\n${envBlock}` : envBlock }),
+    };
     const pluginSkills = (sessionDefaults.plugins ?? []).flatMap((plugin) => plugin.skills ?? []);
     const cwdSkills = await loadSkills(cwdSkillsDir);
     const diskSkills = await loadSkills(skillsDir);
@@ -77,7 +93,7 @@ export const createHarness = async (options) => {
     });
     const spawn = (agent) => persistTo(store, persona(agent, {
         tools: sessionTools(agent),
-        hooks: mergeHooks([sessionDefaults.hooks, allowList(toolNames(agent)), approvalHook(() => agent)]),
+        hooks: mergeHooks([sessionDefaults.hooks, allowList(toolNames(agent)), approvalHook(() => agent), envHook]),
     }));
     const scheduler = enableScheduler && tasks
         ? createScheduler({
@@ -125,7 +141,7 @@ export const createHarness = async (options) => {
         },
         revive: ({ id, model: ref, messages }) => createAgentSession({
             ...sessionDefaults,
-            hooks: mergeHooks([sessionDefaults.hooks, approvalHook(() => approvals?.activeAgent())]),
+            hooks: mergeHooks([sessionDefaults.hooks, approvalHook(() => approvals?.activeAgent()), envHook]),
             tools: sessionTools(undefined, [createSubAgentTool({ registry: agents, spawn, runs, parentId: id })]),
             ...models.resolve(ref),
             id,

package/esm/harness/environment.d.ts

@@ -0,0 +1,10 @@
+export interface EnvironmentInfo {
+    os: string;
+    configDir: string;
+    pluginsDir: string;
+    skillsDir: string;
+    agentsDir: string;
+    hostName: string;
+    hostSourceUrl?: string;
+}
+export declare function environmentBlock(info: EnvironmentInfo): string;

package/esm/harness/environment.js

@@ -0,0 +1,14 @@
+const HARNESS_SOURCE_URL = 'https://github.com/gaetan-puleo/mu-ai';
+export function environmentBlock(info) {
+    const lines = [
+        `Operating system: ${info.os}`,
+        `Config directory: ${info.configDir}`,
+        `Plugins directory: ${info.pluginsDir}`,
+        `Skills directory: ${info.skillsDir}`,
+        `Sub-agents directory: ${info.agentsDir}`,
+        `Harness (mu) source code: ${HARNESS_SOURCE_URL}`,
+    ];
+    if (info.hostSourceUrl)
+        lines.push(`${info.hostName} source code: ${info.hostSourceUrl}`);
+    return `<env>\n${lines.join('\n')}\n</env>`;
+}

package/esm/harness/types.d.ts

@@ -23,6 +23,7 @@ export type HarnessOptions = HarnessConfigOptions & Omit<AgentSessionConfig, 'pr
     title?: boolean;
     titleModel?: string;
     cwd?: string;
+    sourceUrl?: string;
     scheduler?: boolean;
     approvals?: {
         manager: ApprovalManager;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mu-harness",
-  "version": "0.17.1",
+  "version": "0.17.2",
   "description": "Agent harness: createHarness wires mu-core into a host — XDG paths, model registry, plugins, disk-loaded agents & skills, sub-agents, sessions (JSONL + SQLite catalog), slash commands, permission/approval hooks, an optional scheduler, and a composable TUI chat app",
   "license": "MIT",
   "main": "./script/index.js",
@@ -23,8 +23,8 @@
     "@swc/wasm-typescript": "^1.15.0",
     "cli-highlight": "^2.1.11",
     "croner": "^9.0.0",
-    "mu-core": "^0.17.1",
-    "mu-tui": "^0.17.1"
+    "mu-core": "^0.17.2",
+    "mu-tui": "^0.17.2"
   },
   "_generatedBy": "dnt@dev",
   "types": "./esm/index.d.ts"

package/script/harness/create.js

@@ -4,6 +4,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createHarness = void 0;
+const node_os_1 = __importDefault(require("node:os"));
 const node_path_1 = require("node:path");
 const node_process_1 = __importDefault(require("node:process"));
 const index_js_1 = require("../agents/index.js");
@@ -16,6 +17,7 @@ const index_js_7 = require("../scheduler/index.js");
 const index_js_8 = require("../session/index.js");
 const index_js_9 = require("../skills/index.js");
 const index_js_10 = require("../subAgents/index.js");
+const environment_js_1 = require("./environment.js");
 const models_js_1 = require("./models.js");
 const TITLE_AGENT = {
     name: 'title',
@@ -28,13 +30,27 @@ const createHarness = async (options) => {
     const cwd = options.cwd ?? node_process_1.default.cwd();
     const config = (0, index_js_3.createHarnessConfig)({ hostName, xdg });
     const models = (0, models_js_1.createModelRegistry)({ providers, default: model });
-    const plugins = (0, index_js_6.createPluginStore)({ dir: (0, node_path_1.join)(config.configDir, 'plugins') });
+    const pluginsDir = (0, node_path_1.join)(config.configDir, 'plugins');
+    const agentsDir = (0, node_path_1.join)(config.configDir, 'agents');
+    const plugins = (0, index_js_6.createPluginStore)({ dir: pluginsDir });
     const newId = () => crypto.randomUUID();
     const pluginAgents = (sessionDefaults.plugins ?? []).flatMap((plugin) => plugin.agents ?? []);
-    const diskAgents = await (0, index_js_1.loadAgents)((0, node_path_1.join)(config.configDir, 'agents'));
+    const diskAgents = await (0, index_js_1.loadAgents)(agentsDir);
     const agents = (0, index_js_1.createAgentRegistry)([...hostAgents, ...pluginAgents, ...diskAgents]);
     const skillsDir = (0, node_path_1.join)(config.configDir, 'skills');
     const cwdSkillsDir = (0, node_path_1.join)(cwd, 'skills');
+    const envBlock = (0, environment_js_1.environmentBlock)({
+        os: `${node_os_1.default.platform()} ${node_os_1.default.release()} (${node_os_1.default.arch()})`,
+        configDir: config.configDir,
+        pluginsDir,
+        skillsDir,
+        agentsDir,
+        hostName,
+        hostSourceUrl: options.sourceUrl,
+    });
+    const envHook = {
+        prepareRequest: ({ system }) => ({ system: system ? `${system}\n\n${envBlock}` : envBlock }),
+    };
     const pluginSkills = (sessionDefaults.plugins ?? []).flatMap((plugin) => plugin.skills ?? []);
     const cwdSkills = await (0, index_js_9.loadSkills)(cwdSkillsDir);
     const diskSkills = await (0, index_js_9.loadSkills)(skillsDir);
@@ -83,7 +99,7 @@ const createHarness = async (options) => {
     });
     const spawn = (agent) => (0, index_js_8.persistTo)(store, persona(agent, {
         tools: sessionTools(agent),
-        hooks: (0, index_js_4.mergeHooks)([sessionDefaults.hooks, (0, index_js_5.allowList)((0, index_js_1.toolNames)(agent)), approvalHook(() => agent)]),
+        hooks: (0, index_js_4.mergeHooks)([sessionDefaults.hooks, (0, index_js_5.allowList)((0, index_js_1.toolNames)(agent)), approvalHook(() => agent), envHook]),
     }));
     const scheduler = enableScheduler && tasks
         ? (0, index_js_7.createScheduler)({
@@ -131,7 +147,7 @@ const createHarness = async (options) => {
         },
         revive: ({ id, model: ref, messages }) => (0, index_js_8.createAgentSession)({
             ...sessionDefaults,
-            hooks: (0, index_js_4.mergeHooks)([sessionDefaults.hooks, approvalHook(() => approvals?.activeAgent())]),
+            hooks: (0, index_js_4.mergeHooks)([sessionDefaults.hooks, approvalHook(() => approvals?.activeAgent()), envHook]),
             tools: sessionTools(undefined, [(0, index_js_10.createSubAgentTool)({ registry: agents, spawn, runs, parentId: id })]),
             ...models.resolve(ref),
             id,

package/script/harness/environment.d.ts

@@ -0,0 +1,10 @@
+export interface EnvironmentInfo {
+    os: string;
+    configDir: string;
+    pluginsDir: string;
+    skillsDir: string;
+    agentsDir: string;
+    hostName: string;
+    hostSourceUrl?: string;
+}
+export declare function environmentBlock(info: EnvironmentInfo): string;

package/script/harness/environment.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.environmentBlock = environmentBlock;
+const HARNESS_SOURCE_URL = 'https://github.com/gaetan-puleo/mu-ai';
+function environmentBlock(info) {
+    const lines = [
+        `Operating system: ${info.os}`,
+        `Config directory: ${info.configDir}`,
+        `Plugins directory: ${info.pluginsDir}`,
+        `Skills directory: ${info.skillsDir}`,
+        `Sub-agents directory: ${info.agentsDir}`,
+        `Harness (mu) source code: ${HARNESS_SOURCE_URL}`,
+    ];
+    if (info.hostSourceUrl)
+        lines.push(`${info.hostName} source code: ${info.hostSourceUrl}`);
+    return `<env>\n${lines.join('\n')}\n</env>`;
+}

package/script/harness/types.d.ts

@@ -23,6 +23,7 @@ export type HarnessOptions = HarnessConfigOptions & Omit<AgentSessionConfig, 'pr
     title?: boolean;
     titleModel?: string;
     cwd?: string;
+    sourceUrl?: string;
     scheduler?: boolean;
     approvals?: {
         manager: ApprovalManager;