@nikelyh/offscript 1.5.0 → 1.6.1

package/README.md

@@ -6,7 +6,7 @@
 
 **Your users don't follow a script. Neither do ours.**
 
-Current stable release: **v1.0.1** on [npm](https://www.npmjs.com/package/@nikelyh/offscript).
+Current stable release: **v1.7.0** on [npm](https://www.npmjs.com/package/@nikelyh/offscript).
 Online documentation: [offscript.nikelyh.tech](https://offscript.nikelyh.tech).
 
 OFFSCRIPT brings multi-agent software exploration into a local developer workflow: configure a target and goal, choose artificial users, run a bounded session, and inspect observations, investigations and visual evidence in Studio or the terminal.
@@ -36,7 +36,7 @@ npm install -g @nikelyh/offscript
 Or run directly with `npx`:
 
 ```sh
-npx --yes @nikelyh/offscript@1.0.1 studio
+npx --yes @nikelyh/offscript studio
 ```
 
 For browser exploration, install the required Chromium binary:
@@ -110,10 +110,10 @@ From the OFFSCRIPT checkout:
 npm pack
 ```
 
-This builds `nikelyh-offscript-1.0.1.tgz`. From your target project's directory:
+This builds `nikelyh-offscript-*.tgz`. From your target project's directory:
 
 ```sh
-npm exec --yes --package="/absolute/path/nikelyh-offscript-1.0.1.tgz" -- offscript studio
+npm exec --yes --package="/absolute/path/nikelyh-offscript-*.tgz" -- offscript studio
 ```
 
 The current directory becomes the project root. Use a real absolute archive path; Windows paths are supported. npm installs dependencies in its execution cache without adding OFFSCRIPT to the target's package manifest. The first run can need network access and native dependency setup.

package/dist/packages/browser/browser-manager.js

@@ -22,6 +22,7 @@ export class BrowserManager {
             try {
                 const browser = await chromium.launch({
                     headless: this.headless,
+                    args: this.headless ? [] : ["--start-maximized"],
                 });
                 if (this.closed) {
                     await browser.close().catch(() => { });
@@ -50,6 +51,9 @@ export class BrowserManager {
         if (options.storageState) {
             contextOptions.storageState = options.storageState;
         }
+        if (!this.headless) {
+            contextOptions.viewport = null;
+        }
         const context = await browser.newContext(contextOptions);
         const session = await BrowserUserSession.create(context, options);
         this.sessions.add(session);

package/dist/packages/browser/session.js

@@ -60,8 +60,10 @@ export class BrowserUserSession {
         try {
             await this.page.goto(resolvedUrl, {
                 timeout: this.navigationTimeoutMs,
-                waitUntil: "domcontentloaded",
+                waitUntil: "load",
             });
+            // Allow client-side frameworks (e.g. Next.js, React) to settle initial hydration
+            await this.page.evaluate(() => new Promise((resolve) => setTimeout(resolve, 50))).catch(() => { });
             return { success: true, action: "navigate", url: this.page.url() };
         }
         catch (cause) {

package/dist/packages/contracts/simulation-execution.js

@@ -13,9 +13,16 @@ export const simulationExecutionPhases = [
     "interrupted",
 ];
 export function parseStartSimulationRequest(value) {
-    const input = record(value, "startRequest", ["mode"]);
+    const input = record(value, "startRequest", ["mode", "headless"]);
     const mode = oneOf(input.mode, simulationExecutionModes, "startRequest.mode");
-    return Object.freeze({ mode });
+    let headless;
+    if (input.headless !== undefined) {
+        if (typeof input.headless !== "boolean") {
+            throw new ContractValidationError("startRequest.headless", "Expected a boolean.");
+        }
+        headless = input.headless;
+    }
+    return Object.freeze({ mode, ...(headless !== undefined ? { headless } : {}) });
 }
 export function parseSimulationExecutionStatus(value) {
     const input = record(value, "executionStatus", [

package/dist/packages/orchestration/browser-exploration-factory.js

@@ -43,7 +43,7 @@ export function createBrowserExplorationSessionFactory(options = {}) {
         }
         const targetUrl = resolvedTargetUrl;
         const browserManager = createBrowserManager({
-            headless: options.headless ?? true,
+            headless: context?.headless ?? options.headless ?? true,
         });
         const sessions = new Map();
         function getSession(id) {

package/dist/packages/orchestration/investigation-reaction.js

@@ -1,5 +1,5 @@
 import { randomUUID } from "node:crypto";
-import { executeAssignInvestigation } from "../application/index.js";
+import { ApplicationError, executeAssignInvestigation } from "../application/index.js";
 import { decodeEvent, offscriptEventType } from "./event-bridge.js";
 import { situation } from "./situations.js";
 export function investigationReaction({ state, id, maxTurns, store, startTurn }) {
@@ -41,6 +41,12 @@ export function investigationReaction({ state, id, maxTurns, store, startTurn })
         }
         catch (cause) {
             state.reactions.delete(key);
+            if (cause instanceof ApplicationError && cause.code === "INVESTIGATION_CONFLICT") {
+                const reloaded = await store.findInvestigation(decoded.payload.investigation.id).catch(() => undefined);
+                if (reloaded && reloaded.investigation.lifecycle.status !== "requested") {
+                    return;
+                }
+            }
             state.fail("investigation-assignment", id, cause);
         }
         finally {

package/dist/packages/runtime/execution-coordinator.js

@@ -89,7 +89,7 @@ export function executionCoordinator(dependencies) {
             await finalizeExecution(record, outcome, reason);
         });
     }
-    async function start(id, mode) {
+    async function start(id, mode, options = {}) {
         if (closed)
             throw new ApplicationError("EXECUTION_START_FAILED", "Host is closing.");
         if (!factory)
@@ -137,6 +137,7 @@ export function executionCoordinator(dependencies) {
                 mode,
                 targetUrl: config.targetUrl,
                 evidenceStore,
+                ...(options.headless !== undefined ? { headless: options.headless } : {}),
             }));
             record.session = session;
             record.phase = "running";

package/dist/packages/runtime/local-host.js

@@ -197,12 +197,12 @@ export function createLocalHost(options) {
                 deleting.delete(id);
             }
         },
-        async startSimulation(id, mode) {
+        async startSimulation(id, mode, options = {}) {
             if (phase !== "ready" || closing)
                 throw new Error("Host is not accepting execution commands.");
             if (!coordinator)
                 throw new Error("No execution session factory configured on this host.");
-            return coordinator.start(simulationId(id), mode);
+            return coordinator.start(simulationId(id), mode, options);
         },
         async stopSimulation(id) {
             if (phase !== "ready" || closing)

package/dist/packages/server/configuration-routes.js

@@ -44,8 +44,8 @@ export function configurationRoutes(server, services) {
         return value;
     });
     server.post("/api/simulations/:id/start", { bodyLimit: 4096 }, async (request, reply) => {
-        const { mode } = parseStartSimulationRequest(request.body);
-        const status = await services.startSimulation(simulationId(request.params.id), mode);
+        const { mode, headless } = parseStartSimulationRequest(request.body);
+        const status = await services.startSimulation(simulationId(request.params.id), mode, { headless });
         return reply.code(200).send(status);
     });
     server.get("/api/simulations/:id/execution", async (request) => {

package/dist/scripts/server/run.js

@@ -7,10 +7,16 @@ import { startupError } from "./startup-error.js";
 process.env.MOZAIK_API_KEY ??= "";
 const originalWarn = console.warn;
 console.warn = (...args) => {
-    if (typeof args[0] === "string" && args[0].includes("mozaik cloud: no API key"))
+    if (typeof args[0] === "string" && args[0].includes("mozaik cloud"))
         return;
     originalWarn.apply(console, args);
 };
+const originalStderrWrite = process.stderr.write.bind(process.stderr);
+process.stderr.write = ((chunk, ...rest) => {
+    if (typeof chunk === "string" && chunk.includes("mozaik cloud"))
+        return true;
+    return originalStderrWrite(chunk, ...rest);
+});
 let requestStop = () => { };
 const stopping = new Promise(resolve => { requestStop = resolve; });
 let interrupted = false;
@@ -47,6 +53,8 @@ try {
                 });
             }
         }
+        console.log("AI Mode: Local Autonomous Runner (offline, no API key required).");
+        console.log("Browser exploration requires Chromium: npx playwright install chromium");
         console.log("Press Ctrl+C to stop. No exploration starts automatically.");
         await stopping;
     }