@zenera/engine 1.1.53 → 1.1.54

package/dist/engine.js

@@ -21,6 +21,9 @@ export async function openEngine(opts) {
     const logger = opts.logger ?? stderrLogger;
     const onIssue = opts.onIssue ?? ((issue) => logger.warn(describeIssue(issue)));
     const user = resolveUser(opts.user);
+    // The machine's plugins are imported before the project's env file is read: a plugin may
+    // configure itself from the environment when imported, and that must be the host's.
+    const machinePlugins = opts.envPlugins === false ? [] : await envPlugins(logger);
     // Before the keyring, so the project's own file wins over the machine's
     // keys, and before the load, so `${VAR}` in agents.yaml can name anything
     // in it. The real environment still beats both.
@@ -29,7 +32,7 @@ export async function openEngine(opts) {
         logger.warn(`${env.path} sets ${env.refused.join(', ')} — ignored: who a run acts for, and ` +
             'which plugins load, are the host’s to say (zen run --as <user> to try one)');
     }
-    const hostPlugins = mergePlugins(opts.plugins ?? [], opts.envPlugins === false ? [] : await envPlugins(logger));
+    const hostPlugins = mergePlugins(opts.plugins ?? [], machinePlugins);
     const keys = await KeyStore.open();
     keys.materialize();
     assertUsable(keys);

package/dist/plugins.d.ts

@@ -11,7 +11,8 @@ export interface PluginContext {
         dir: string;
         name: string;
     };
-    session: SessionPaths;
+    /** the session the run belongs to; absent when tools are only listed (`zen check`) */
+    session?: SessionPaths;
     logger: Logger;
 }
 export interface ZenPlugin {
@@ -45,4 +46,13 @@ export declare function envPlugins(logger: Logger): Promise<ZenPlugin[]>;
 export declare function importPlugins(list: string | undefined, logger: Logger): Promise<ZenPlugin[]>;
 /** The host's plugins and the machine's, the host's winning where both name one. */
 export declare function mergePlugins(given: readonly ZenPlugin[], machine: readonly ZenPlugin[]): ZenPlugin[];
+/**
+ * The tools the machine's plugins add, for checking a project rather than
+ * running it: the plugins are asked with no user and no session, and closed
+ * again. A plugin that fails or clashes is a warning, and adds nothing.
+ */
+export declare function machinePluginTools(project: {
+    dir: string;
+    name: string;
+}, builtins: readonly AnyTool[], logger: Logger): Promise<AnyTool[]>;
 //# sourceMappingURL=plugins.d.ts.map

package/dist/plugins.js

@@ -137,4 +137,26 @@ export function mergePlugins(given, machine) {
     const names = new Set(given.map((p) => p.name));
     return [...given, ...machine.filter((p) => !names.has(p.name))];
 }
+/**
+ * The tools the machine's plugins add, for checking a project rather than
+ * running it: the plugins are asked with no user and no session, and closed
+ * again. A plugin that fails or clashes is a warning, and adds nothing.
+ */
+export async function machinePluginTools(project, builtins, logger) {
+    const tools = [];
+    for (const plugin of await envPlugins(logger)) {
+        try {
+            const loaded = await loadPlugins([plugin], { project, logger }, [
+                ...builtins,
+                ...tools,
+            ]);
+            await loaded.close();
+            tools.push(...loaded.tools);
+        }
+        catch (err) {
+            logger.warn(`${PLUGINS_ENV}: ${message(err)} — its tools are left out`);
+        }
+    }
+    return tools;
+}
 //# sourceMappingURL=plugins.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@zenera/engine",
-    "version": "1.1.53",
+    "version": "1.1.54",
     "description": "Runs a @zenera/neo project on this machine: keyring, sandbox, sessions and the record each turn leaves behind.",
     "keywords": [
         "agents",
@@ -45,6 +45,6 @@
         "prepack": "tsc -b"
     },
     "dependencies": {
-        "@zenera/neo": "^1.1.53"
+        "@zenera/neo": "^1.1.54"
     }
 }