@north-light/crouter 0.3.316 → 0.3.317

package/dist/core/__tests__/fixtures/fake-engine.d.ts

@@ -298,14 +298,15 @@ interface FakeServices {
     resourceLoader: ResourceLoader;
     modelRuntime: FakeModelRuntime;
 }
+type FakeResourceLoaderOptions = {
+    additionalExtensionPaths?: string[];
+    appendSystemPrompt?: string[];
+};
 export declare function createAgentSessionServices(options: {
     cwd: string;
     agentDir?: string;
     modelRuntime?: unknown;
-    resourceLoaderOptions?: {
-        additionalExtensionPaths?: string[];
-        appendSystemPrompt?: string[];
-    };
+    resourceLoaderOptions?: FakeResourceLoaderOptions;
 }): Promise<FakeServices>;
 export declare function createAgentSessionFromServices(options: {
     services: FakeServices;

package/dist/core/__tests__/fixtures/fake-engine.js

@@ -31,11 +31,12 @@
 //   <nodeDir>/fake-pi.dialog.jsonl   — one line per resolved unattended dialog (§5.4)
 import { spawn } from 'node:child_process';
 import { writeFileSync, readFileSync, existsSync, mkdirSync, appendFileSync, unlinkSync, } from 'node:fs';
-import { join, dirname } from 'node:path';
+import { join, dirname, resolve } from 'node:path';
 import { randomUUID } from 'node:crypto';
-import { DefaultResourceLoader, getAgentDir } from '@earendil-works/pi-coding-agent';
+import { DefaultPackageManager, DefaultResourceLoader, getAgentDir, SettingsManager } from '@earendil-works/pi-coding-agent';
 import { MANAGED_PROVIDER_COOLING_DIAGNOSTIC } from '../../runtime/managed-provider-cooling.js';
 import { PROVIDER_FAILURE_DIAGNOSTIC } from '../../provider-failure.js';
+import { CANVAS_EXTENSIONS } from '../../runtime/canvas-extensions.js';
 import registerCanvasBashValve, { createValveOperations } from '../../../pi-extensions/canvas-bash-valve.js';
 /** Test seams for prompt-scoped failures before session_start. The one-shot
  *  variant records its first failure per node so the next cycling retry can
@@ -678,6 +679,14 @@ class FakeSession {
         // A turn consumes whatever was queued for it, as the real session does.
         this.steering.length = 0;
         this.followUps.length = 0;
+        let releaseGate;
+        if (process.env['PI_FAKE_ENGINE_HOLD_TURN'] === '1') {
+            let release;
+            let resolveSettled;
+            const settled = new Promise((resolve) => { resolveSettled = resolve; });
+            releaseGate = new Promise((resolve) => { release = resolve; });
+            this.heldTurn = { release, settled, resolveSettled };
+        }
         this.streaming = true;
         if (opts.runHooks === true) {
             await this.fire('agent_start', {}, this.buildCtx());
@@ -685,14 +694,7 @@ class FakeSession {
         this.emit({ type: 'agent_start' });
         this.emit({ type: 'turn_start' });
         this.emit({ type: 'message_start', message: small });
-        if (process.env['PI_FAKE_ENGINE_HOLD_TURN'] === '1') {
-            let release;
-            let resolveSettled;
-            const settled = new Promise((resolve) => { resolveSettled = resolve; });
-            const releaseGate = new Promise((resolve) => { release = resolve; });
-            this.heldTurn = { release, settled, resolveSettled };
-            await releaseGate;
-        }
+        await releaseGate;
         // F2 (message_update coalescing): the broker now coalesces message_update
         // relays (latest-wins, ~75 ms window), so a padded flood riding message_update
         // can no longer climb a stalled viewer's backlog — the coalescer would shed
@@ -1291,14 +1293,93 @@ const FAKE_REGISTERED_MODELS = [
     { provider: 'openai-codex', id: 'gpt-5.6-luna' },
     FAKE_AVAILABLE_MODEL,
 ];
+/** Source harnesses use native imports only for an isolated, mandatory-only
+ * canvas fixture. Every other source stays on the SDK file-loader path. */
+async function sourceCanvasExtensionLoaderOptions(cwd, agentDir, options) {
+    const extensionPaths = options?.additionalExtensionPaths;
+    const mandatoryOnly = extensionPaths?.length === CANVAS_EXTENSIONS.length
+        && extensionPaths.every((path, index) => path === CANVAS_EXTENSIONS[index]);
+    if (!import.meta.url.endsWith('.ts') || !mandatoryOnly)
+        return { additionalExtensionPaths: extensionPaths };
+    const settingsManager = SettingsManager.create(cwd, agentDir);
+    const resolved = await new DefaultPackageManager({ cwd, agentDir, settingsManager }).resolve();
+    if (resolved.extensions.some((extension) => extension.enabled)) {
+        return { additionalExtensionPaths: extensionPaths, settingsManager };
+    }
+    const inlinePaths = new Map();
+    const fileLoaderErrors = new Map();
+    const missingPaths = [];
+    const extensionFactories = [];
+    for (const inputPath of extensionPaths) {
+        const path = resolve(cwd, inputPath);
+        if (!existsSync(path)) {
+            missingPaths.push(path);
+            continue;
+        }
+        inlinePaths.set(`<inline:${path}>`, path);
+        let factory;
+        try {
+            const loaded = await import(path);
+            if (typeof loaded.default !== 'function') {
+                fileLoaderErrors.set(path, `Extension does not export a valid factory function: ${path}`);
+                factory = () => { throw new Error(fileLoaderErrors.get(path)); };
+            }
+            else {
+                factory = loaded.default;
+            }
+        }
+        catch {
+            // Let the original loader produce its own import/transform diagnostic.
+            return { additionalExtensionPaths: extensionPaths, settingsManager };
+        }
+        extensionFactories.push({ name: path, factory });
+    }
+    return {
+        additionalExtensionPaths: [],
+        extensionFactories,
+        settingsManager,
+        restoreCliExtensionMetadata: (loader) => {
+            const result = loader.getExtensions();
+            for (const extension of result.extensions) {
+                const path = inlinePaths.get(extension.path);
+                if (path === undefined)
+                    continue;
+                const sourceInfo = { path, source: 'cli', scope: 'temporary', origin: 'top-level', baseDir: undefined };
+                extension.path = path;
+                extension.resolvedPath = path;
+                extension.sourceInfo = sourceInfo;
+                for (const command of extension.commands.values())
+                    command.sourceInfo = sourceInfo;
+                for (const tool of extension.tools.values())
+                    tool.sourceInfo = sourceInfo;
+            }
+            for (const error of result.errors) {
+                const path = inlinePaths.get(error.path);
+                if (path !== undefined) {
+                    error.path = path;
+                    const isConflict = /^(?:Tool|Flag) ".*" conflicts with /.test(error.error);
+                    error.error = fileLoaderErrors.get(path) ?? (isConflict ? error.error : `Failed to load extension: ${error.error}`);
+                }
+                for (const [inlinePath, filePath] of inlinePaths) {
+                    error.error = error.error.replaceAll(inlinePath, filePath);
+                }
+            }
+            result.errors.push(...missingPaths.map((path) => ({ path, error: `Extension path does not exist: ${path}` })));
+        },
+    };
+}
 export async function createAgentSessionServices(options) {
+    const agentDir = options.agentDir ?? getAgentDir();
+    const extensionOptions = await sourceCanvasExtensionLoaderOptions(options.cwd, agentDir, options.resourceLoaderOptions);
+    const { restoreCliExtensionMetadata, ...loaderOptions } = extensionOptions;
     const loader = new DefaultResourceLoader({
         cwd: options.cwd,
-        agentDir: options.agentDir ?? getAgentDir(),
-        additionalExtensionPaths: options.resourceLoaderOptions?.additionalExtensionPaths,
+        agentDir,
+        ...loaderOptions,
         appendSystemPrompt: options.resourceLoaderOptions?.appendSystemPrompt,
     });
     await loader.reload();
+    restoreCliExtensionMetadata?.(loader);
     // Zero-auth test seam. While <CRTR_HOME>/fake-pi.no-auth exists, the registry
     // reports a GENUINE zero-auth boot (nothing registered, nothing authenticated)
     // so resolveLaunchModel (broker.ts) falls all the way to a tier-3 model-less

package/dist/core/__tests__/seam/broker-provider-retry.test.js

@@ -367,6 +367,8 @@ test('reload_auth re-drives a parked fatal provider-auth turn exactly once', { t
     await seedPool('openai-codex', false);
     const child = await h.spawnHeadlessChild(parent, 'auth reload child', { model: OPENAI_STRONG.spec });
     await h.waitFor(() => agentStartCount(child) >= 1, { label: 'initial auth fixture turn started' });
+    const kickoffObserver = await attachUntil(child, 'observer', 'auth-reload-kickoff-settled', (a) => a.welcome.snapshot.state.isStreaming === false, 'auth reload kickoff settled');
+    kickoffObserver.close();
     const baselineStarts = agentStartCount(child);
     h.fakeCmd(child, {
         cmd: 'stop',
@@ -397,6 +399,8 @@ test('reload_auth leaves a parked auth fault with its original session when navi
     await seedPool('openai-codex', false);
     const child = await h.spawnHeadlessChild(parent, 'auth replacement child', { model: OPENAI_STRONG.spec });
     await h.waitFor(() => agentStartCount(child) >= 1, { label: 'initial replacement fixture turn started' });
+    const kickoffObserver = await attachUntil(child, 'observer', 'auth-replacement-kickoff-settled', (a) => a.welcome.snapshot.state.isStreaming === false, 'auth replacement kickoff settled');
+    kickoffObserver.close();
     h.fakeCmd(child, {
         cmd: 'stop',
         reason: 'error',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/crouter",
-  "version": "0.3.316",
+  "version": "0.3.317",
   "description": "crtr — agent runtime with memory, plugins, and marketplaces",
   "type": "module",
   "main": "dist/index.js",

package/runtime.lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@north-light/crouter",
-  "version": "0.3.316",
+  "version": "0.3.317",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@north-light/crouter",
-      "version": "0.3.316",
+      "version": "0.3.317",
       "hasInstallScript": true,
       "license": "MIT",
       "workspaces": [
@@ -5206,17 +5206,17 @@
     },
     "packages/crouter-api": {
       "name": "@north-light/crouter-api",
-      "version": "0.3.316",
+      "version": "0.3.317",
       "license": "UNLICENSED"
     },
     "packages/crouter-env-docker": {
       "name": "@north-light/crouter-env-docker",
-      "version": "0.3.316",
+      "version": "0.3.317",
       "license": "UNLICENSED"
     },
     "packages/crouter-sdk": {
       "name": "@north-light/crouter-sdk",
-      "version": "0.3.316",
+      "version": "0.3.317",
       "license": "UNLICENSED",
       "dependencies": {
         "@north-light/crouter-api": "^0.3.295"