@quenty/nevermore-cli 4.43.3 → 4.44.0

package/dist/utils/job-context/cloud-job-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"cloud-job-context.js","sourceRoot":"","sources":["../../../src/utils/job-context/cloud-job-context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cloud-job-context.js","sourceRoot":"","sources":["../../../src/utils/job-context/cloud-job-context.ts"],"names":[],"mappings":"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"}

package/dist/utils/job-context/cloud-job-context.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Unit tests for CloudJobContext.runScriptAsync — validates what a finished
+ * Open Cloud task reports back as a ScriptRunResult, in particular that a task
+ * which produced no output stays distinguishable from one that returned nothing.
+ */
+export {};
+//# sourceMappingURL=cloud-job-context.test.d.ts.map

package/dist/utils/job-context/cloud-job-context.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-job-context.test.d.ts","sourceRoot":"","sources":["../../../src/utils/job-context/cloud-job-context.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/utils/job-context/cloud-job-context.test.js

@@ -0,0 +1,91 @@
+/**
+ * Unit tests for CloudJobContext.runScriptAsync — validates what a finished
+ * Open Cloud task reports back as a ScriptRunResult, in particular that a task
+ * which produced no output stays distinguishable from one that returned nothing.
+ */
+import { describe, it, expect, vi, afterEach } from 'vitest';
+import { CloudJobContext } from './cloud-job-context.js';
+function createReporter() {
+    return {
+        onPackagePhaseChange: vi.fn(),
+        onPackageProgressUpdate: vi.fn(),
+        onPackageStart: vi.fn(),
+        onPackageResult: vi.fn(),
+    };
+}
+/**
+ * A client whose task completes as `completedTask`. The real deployment handle
+ * is private to the context, so the test passes the three fields runScriptAsync
+ * reads off it.
+ */
+function createContext(completedTask) {
+    const task = {
+        path: 'universes/1/places/2/versions/3/luau-execution-session-tasks/4',
+        createTime: '2026-01-01T00:00:00Z',
+        updateTime: '2026-01-01T00:01:00Z',
+        user: 'users/1',
+        state: 'COMPLETE',
+        script: 'return 1',
+        ...completedTask,
+    };
+    const client = {
+        createExecutionTaskAsync: vi.fn(async () => task),
+        pollTaskCompletionAsync: vi.fn(async () => task),
+    };
+    const context = new CloudJobContext(createReporter(), client);
+    const deployment = {
+        universeId: 1,
+        placeId: 2,
+        version: 3,
+    };
+    return { context, deployment };
+}
+describe('CloudJobContext.runScriptAsync', () => {
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it('reports the values the script returned', async () => {
+        // Fake timers keep the client-side timeout race from leaving a live timer
+        // behind; nothing in the run itself waits on one.
+        vi.useFakeTimers();
+        const { context, deployment } = createContext({
+            state: 'COMPLETE',
+            output: { results: [{ slug: 'maid', counts: { passed: 1014 } }] },
+        });
+        const result = await context.runScriptAsync(deployment, {
+            scriptContent: 'return results',
+            packageName: 'maid',
+        });
+        expect(result.success).toBe(true);
+        expect(result.returnValues).toEqual([
+            { slug: 'maid', counts: { passed: 1014 } },
+        ]);
+    });
+    it('reports an empty result when the task returned nothing', async () => {
+        vi.useFakeTimers();
+        const { context, deployment } = createContext({
+            state: 'COMPLETE',
+            output: {},
+        });
+        const result = await context.runScriptAsync(deployment, {
+            scriptContent: 'print("hi")',
+            packageName: 'maid',
+        });
+        expect(result.returnValues).toEqual([]);
+    });
+    it('leaves returnValues absent when a failed task carried no output', async () => {
+        vi.useFakeTimers();
+        const { context, deployment } = createContext({
+            state: 'FAILED',
+            output: undefined,
+        });
+        const result = await context.runScriptAsync(deployment, {
+            scriptContent: 'return huge',
+            packageName: 'maid',
+        });
+        expect(result.success).toBe(false);
+        expect(result.taskState).toBe('FAILED');
+        expect(result.returnValues).toBeUndefined();
+    });
+});
+//# sourceMappingURL=cloud-job-context.test.js.map

package/dist/utils/job-context/cloud-job-context.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-job-context.test.js","sourceRoot":"","sources":["../../../src/utils/job-context/cloud-job-context.test.ts"],"names":[],"mappings":"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"}

package/dist/utils/job-context/job-context.d.ts

@@ -1,4 +1,23 @@
 import { type BuildPlaceOptions, type BuiltPlace } from '../build/build.js';
+import { type StructuredTestResults } from '../testing/structured-test-results.js';
+import { type LogFetchStats } from '../testing/log-fetch-stats.js';
+import { type TaskLogMessage } from '../open-cloud/open-cloud-client.js';
+/** A run's output, with the severity and the fetch that produced it. */
+export interface JobLogs {
+    text: string;
+    /**
+     * The same output split into typed messages, when the transport reports
+     * severity. Empty for one that does not — a local run reads its logs off the
+     * Studio bridge, which says only what was printed.
+     */
+    messages: TaskLogMessage[];
+    /**
+     * What collecting them took, when the transport can say. Absent rather than
+     * zeroed, so "no fetch to measure" cannot read as "a fetch that found
+     * nothing".
+     */
+    stats?: LogFetchStats;
+}
 export type { BuiltPlace } from '../build/build.js';
 export interface DeployPlaceOptions {
     builtPlace: BuiltPlace;
@@ -24,6 +43,48 @@ export interface ScriptRunResult {
     taskState?: string;
     /** Error message from the execution backend, if any. */
     errorMessage?: string;
+    /**
+     * Everything the executed script returned, in order — the structured channel
+     * out of a run, as opposed to its printed output. Engine logs are truncated
+     * by Open Cloud on long runs, so anything a caller must read back exactly
+     * belongs here rather than in the log text.
+     *
+     * `undefined` means the transport never delivered a return channel: a cloud
+     * task that ended without an `output` (a FAILED task carries none, and an
+     * oversize return value fails the task rather than truncating the value), a
+     * bridge run that timed out or disconnected, or a context that does not
+     * carry return values at all. That is deliberately distinct from `[]`, which
+     * means the script ran and returned nothing — a caller that needs the value
+     * can fall back to parsing logs in the first case but not the second.
+     *
+     * Values are JSON-shaped, but the two transports spell exotic Luau types
+     * differently: Open Cloud auto-serializes them, while the Studio bridge
+     * marshals them into `{ type, value }` wrappers (`SerializedReturnValue`).
+     * Plain tables of strings, numbers and booleans come back identically on
+     * both, so structured results should stay inside that subset.
+     */
+    returnValues?: unknown[];
+    /**
+     * The run's structured test results, when the context resolved them itself
+     * rather than leaving them in `returnValues` for the caller to decode.
+     *
+     * Only aggregated batch mode sets this: one execution covers every package, so
+     * its return value belongs to no single one of them and the per-package
+     * results have to be recovered from the batch summary first. A context that
+     * sets this has also reported where the counts came from, so the caller does
+     * not report it a second time.
+     */
+    testResults?: StructuredTestResults;
+    /**
+     * True when this run's verdict rests on returned results alone, its log
+     * output having been dropped before it reached us.
+     *
+     * A narrower verdict than an ordinary one: the counts are exact, but with no
+     * text there is nothing to check for tracebacks and nothing to read when
+     * something did go wrong. Reported so it can be shown as such rather than as
+     * an ordinary pass.
+     */
+    logsLost?: boolean;
 }
 /**
  * Opaque handle representing a single deployed place.
@@ -38,8 +99,15 @@ export interface JobContext {
     deployBuiltPlaceAsync(options: DeployPlaceOptions): Promise<Deployment>;
     /** Execute a Luau script in a deployed place. */
     runScriptAsync(deployment: Deployment, options: RunScriptOptions): Promise<ScriptRunResult>;
-    /** Retrieve raw logs from the most recent script execution on this deployment. */
-    getLogsAsync(deployment: Deployment): Promise<string>;
+    /**
+     * Everything the most recent script execution printed.
+     *
+     * One value rather than a log plus two optional side-channels for its
+     * severity and its fetch: they all come from the same fetch, so returning
+     * them together removes both the chance of asking a context that does not
+     * implement one and the chance of handing an accessor the wrong handle.
+     */
+    getLogsAsync(deployment: Deployment): Promise<JobLogs>;
     /** Release a single deployment (stop bridge / clear task metadata). */
     releaseAsync(deployment: Deployment): Promise<void>;
     /** Eagerly release a built place's temporary resources. Idempotent. */

package/dist/utils/job-context/job-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"job-context.d.ts","sourceRoot":"","sources":["../../../src/utils/job-context/job-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE5E,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,4EAA4E;IAC5E,OAAO,EAAE,OAAO,CAAC;IACjB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AAEH,MAAM,WAAW,UAAU;CAAG;AAE9B,MAAM,WAAW,UAAU;IACzB,6FAA6F;IAC7F,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEjE,qGAAqG;IACrG,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAExE,iDAAiD;IACjD,cAAc,CACZ,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAAC;IAE5B,kFAAkF;IAClF,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEtD,uEAAuE;IACvE,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD,uEAAuE;IACvE,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9D,wGAAwG;IACxG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B"}
+{"version":3,"file":"job-context.d.ts","sourceRoot":"","sources":["../../../src/utils/job-context/job-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AACnF,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,wEAAwE;AACxE,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B;;;;OAIG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,4EAA4E;IAC5E,OAAO,EAAE,OAAO,CAAC;IACjB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC;IACzB;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AAEH,MAAM,WAAW,UAAU;CAAG;AAE9B,MAAM,WAAW,UAAU;IACzB,6FAA6F;IAC7F,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEjE,qGAAqG;IACrG,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAExE,iDAAiD;IACjD,cAAc,CACZ,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAAC;IAE5B;;;;;;;OAOG;IACH,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvD,uEAAuE;IACvE,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD,uEAAuE;IACvE,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9D,wGAAwG;IACxG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B"}

package/dist/utils/job-context/local-job-context.d.ts

@@ -1,5 +1,5 @@
 import { type Reporter } from '@quenty/cli-output-helpers/reporting';
-import { type Deployment, type DeployPlaceOptions, type RunScriptOptions, type ScriptRunResult } from './job-context.js';
+import { type Deployment, type DeployPlaceOptions, type RunScriptOptions, type ScriptRunResult, type JobLogs } from './job-context.js';
 import { type BasePlaceResolver } from '@quenty/nevermore-deploy';
 import { BaseJobContext } from './base-job-context.js';
 import { type OpenCloudClient } from '../open-cloud/open-cloud-client.js';
@@ -8,7 +8,7 @@ export declare class LocalJobContext extends BaseJobContext {
     constructor(reporter: Reporter, openCloudClient?: OpenCloudClient, basePlaceResolver?: BasePlaceResolver);
     deployBuiltPlaceAsync(options: DeployPlaceOptions): Promise<Deployment>;
     runScriptAsync(deployment: Deployment, options: RunScriptOptions): Promise<ScriptRunResult>;
-    getLogsAsync(deployment: Deployment): Promise<string>;
+    getLogsAsync(deployment: Deployment): Promise<JobLogs>;
     releaseAsync(deployment: Deployment): Promise<void>;
     disposeAsync(): Promise<void>;
 }

package/dist/utils/job-context/local-job-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-job-context.d.ts","sourceRoot":"","sources":["../../../src/utils/job-context/local-job-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AAErE,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAa1E,qBAAa,eAAgB,SAAQ,cAAc;IACjD,OAAO,CAAC,YAAY,CAA8B;gBAGhD,QAAQ,EAAE,QAAQ,EAClB,eAAe,CAAC,EAAE,eAAe,EACjC,iBAAiB,CAAC,EAAE,iBAAiB;IAKjC,qBAAqB,CACzB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,UAAU,CAAC;IAmBhB,cAAc,CAClB,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC;IAqBrB,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAKrD,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAWnD,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;CAOpC"}
+{"version":3,"file":"local-job-context.d.ts","sourceRoot":"","sources":["../../../src/utils/job-context/local-job-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AAErE,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,OAAO,EACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAa1E,qBAAa,eAAgB,SAAQ,cAAc;IACjD,OAAO,CAAC,YAAY,CAA8B;gBAGhD,QAAQ,EAAE,QAAQ,EAClB,eAAe,CAAC,EAAE,eAAe,EACjC,iBAAiB,CAAC,EAAE,iBAAiB;IAKjC,qBAAqB,CACzB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,UAAU,CAAC;IAmBhB,cAAc,CAClB,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC;IAqBrB,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAQtD,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAWnD,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;CAOpC"}

package/dist/utils/job-context/local-job-context.js

@@ -39,7 +39,7 @@ export class LocalJobContext extends BaseJobContext {
                 timeoutMs,
             });
             localDeployment.cachedLogs = result.logs;
-            return { success: result.success };
+            return { success: result.success, returnValues: result.returnValues };
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
@@ -49,7 +49,9 @@ export class LocalJobContext extends BaseJobContext {
     }
     async getLogsAsync(deployment) {
         const localDeployment = deployment;
-        return localDeployment.cachedLogs;
+        // No severity and no fetch: the bridge hands over text it already has.
+        // Both stay absent rather than being invented.
+        return { text: localDeployment.cachedLogs, messages: [] };
     }
     async releaseAsync(deployment) {
         const localDeployment = deployment;

package/dist/utils/job-context/local-job-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"local-job-context.js","sourceRoot":"","sources":["../../../src/utils/job-context/local-job-context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"local-job-context.js","sourceRoot":"","sources":["../../../src/utils/job-context/local-job-context.ts"],"names":[],"mappings":"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"}

package/dist/utils/job-context/local-job-context.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Unit tests for LocalJobContext.runScriptAsync — validates that a bridge run
+ * hands its script return values on as a ScriptRunResult, and that a run which
+ * never completed reports none rather than an empty result.
+ */
+export {};
+//# sourceMappingURL=local-job-context.test.d.ts.map

package/dist/utils/job-context/local-job-context.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-job-context.test.d.ts","sourceRoot":"","sources":["../../../src/utils/job-context/local-job-context.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/utils/job-context/local-job-context.test.js

@@ -0,0 +1,68 @@
+/**
+ * Unit tests for LocalJobContext.runScriptAsync — validates that a bridge run
+ * hands its script return values on as a ScriptRunResult, and that a run which
+ * never completed reports none rather than an empty result.
+ */
+import { describe, it, expect, vi } from 'vitest';
+import { LocalJobContext } from './local-job-context.js';
+function createReporter() {
+    return {
+        onPackagePhaseChange: vi.fn(),
+        onPackageProgressUpdate: vi.fn(),
+        onPackageStart: vi.fn(),
+        onPackageResult: vi.fn(),
+    };
+}
+/**
+ * The deployment handle is private to the context, so the test stands in a
+ * bridge with the one method runScriptAsync calls on it.
+ */
+function createDeployment(executeAsync) {
+    return {
+        bridge: { executeAsync },
+        cachedLogs: '',
+    };
+}
+describe('LocalJobContext.runScriptAsync', () => {
+    it('reports the values the script returned', async () => {
+        const context = new LocalJobContext(createReporter());
+        const deployment = createDeployment(async () => ({
+            success: true,
+            logs: 'ran',
+            returnValues: [{ counts: { passed: 7 } }],
+        }));
+        const result = await context.runScriptAsync(deployment, {
+            scriptContent: 'return results',
+            packageName: 'maid',
+        });
+        expect(result.success).toBe(true);
+        expect(result.returnValues).toEqual([{ counts: { passed: 7 } }]);
+        expect((await context.getLogsAsync(deployment)).text).toBe('ran');
+    });
+    it('leaves returnValues absent when the bridge reported none', async () => {
+        const context = new LocalJobContext(createReporter());
+        const deployment = createDeployment(async () => ({
+            success: false,
+            logs: '[StudioBridge] Timed out after 200ms',
+        }));
+        const result = await context.runScriptAsync(deployment, {
+            scriptContent: 'while true do end',
+            packageName: 'maid',
+        });
+        expect(result.returnValues).toBeUndefined();
+    });
+    it('leaves returnValues absent when the bridge throws', async () => {
+        const context = new LocalJobContext(createReporter());
+        const deployment = createDeployment(async () => {
+            throw new Error('no connected client');
+        });
+        const result = await context.runScriptAsync(deployment, {
+            scriptContent: 'return results',
+            packageName: 'maid',
+        });
+        expect(result.success).toBe(false);
+        expect(result.returnValues).toBeUndefined();
+        expect((await context.getLogsAsync(deployment)).text).toContain('no connected client');
+    });
+});
+//# sourceMappingURL=local-job-context.test.js.map

package/dist/utils/job-context/local-job-context.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-job-context.test.js","sourceRoot":"","sources":["../../../src/utils/job-context/local-job-context.test.ts"],"names":[],"mappings":"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"}

package/dist/utils/open-cloud/open-cloud-client.d.ts

@@ -1,5 +1,27 @@
 import { RateLimiter } from './rate-limiter.js';
 import { type ParsedTestLogs } from '../testing/test-log-parser.js';
+import { type LogFetchStats } from '../testing/log-fetch-stats.js';
+/**
+ * One engine message, with the severity Open Cloud reported for it.
+ *
+ * A message is not a line: an error arrives with its whole traceback attached,
+ * so `message` can span several. `messageType` is OUTPUT, WARNING or ERROR.
+ */
+export interface TaskLogMessage {
+    message: string;
+    messageType?: string;
+}
+/** A task's log text together with what the fetch had to do to collect it. */
+export interface TaskLogFetch {
+    text: string;
+    stats: LogFetchStats;
+    /**
+     * The same output as `text`, still split into typed messages. Kept because
+     * severity is the API's to state and cannot be recovered from the joined
+     * text: a traceback's continuation lines look like ordinary output.
+     */
+    messages: TaskLogMessage[];
+}
 export interface LuauTask {
     path: string;
     createTime: string;
@@ -8,11 +30,20 @@ export interface LuauTask {
     state: 'STATE_UNSPECIFIED' | 'QUEUED' | 'PROCESSING' | 'CANCELLED' | 'COMPLETE' | 'FAILED';
     script: string;
     timeout?: string;
-    /** Script return value (populated on COMPLETE). */
+    /**
+     * What the script returned, populated on COMPLETE. `results` is a flat array
+     * of the returned values — `return t, "s", 42` arrives as three entries —
+     * natively typed: Roblox serializes them itself, so a returned Lua table is
+     * real nested JSON here, not a JSON string. (Which is also why a script must
+     * not JSONEncode its result: that lands as a double-encoded string.)
+     *
+     * Absent whenever the task produced no result. A FAILED task carries no
+     * `output` at all, with no error message explaining why — and an oversize
+     * return value (~4MB observed; ~2MB still arrives complete) fails the task
+     * exactly that way rather than truncating the value.
+     */
     output?: {
-        results?: Array<{
-            value?: string;
-        }>;
+        results?: unknown[];
     };
     /** Error details (populated on FAILED). */
     error?: {
@@ -20,6 +51,15 @@ export interface LuauTask {
         message?: string;
     };
 }
+/**
+ * The values a finished task's script returned, or `undefined` when the task
+ * reported no result at all.
+ *
+ * The distinction matters: `undefined` means nothing came back to read, so a
+ * caller can fall back to the task's logs, while `[]` means the task did report
+ * a result and the script returned nothing — no fallback will find more.
+ */
+export declare function getTaskReturnValues(task: LuauTask): unknown[] | undefined;
 export interface OpenCloudClientOptions {
     apiKey: string | (() => Promise<string>);
     rateLimiter: RateLimiter;
@@ -41,11 +81,14 @@ export declare class OpenCloudClient {
     pollTaskCompletionAsync(taskPath: string, onProgress?: (state: LuauTask['state']) => void): Promise<LuauTask>;
     getTaskLogsAsync(taskPath: string): Promise<ParsedTestLogs>;
     /**
-     * Fetch raw log text from a completed Luau execution task.
+     * Fetch raw log text from a completed Luau execution task, along with the
+     * shape of the fetch that produced it.
+     *
      * Retries a few times if the API returns empty logs, since the test runner
-     * always produces at least some output.
+     * always produces at least some output. The reported `requests` count spans
+     * every attempt, so a fetch that only filled in on its third try says so.
      */
-    getRawTaskLogsAsync(taskPath: string): Promise<string>;
+    getRawTaskLogsAsync(taskPath: string): Promise<TaskLogFetch>;
     private _fetchRawLogsAsync;
     /**
      * Download a place file via the Asset Delivery API.

package/dist/utils/open-cloud/open-cloud-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"open-cloud-client.d.ts","sourceRoot":"","sources":["../../../src/utils/open-cloud/open-cloud-client.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAkB,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,+BAA+B,CAAC;AAEvC,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EACD,mBAAmB,GACnB,QAAQ,GACR,YAAY,GACZ,WAAW,GACX,UAAU,GACV,QAAQ,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,KAAK,CAAC;YAAE,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IACjD,2CAA2C;IAC3C,KAAK,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IACzC,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,WAAW,CAAC;AAsDrD,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,aAAa,CAAmC;IACxD,OAAO,CAAC,YAAY,CAAc;gBAEtB,OAAO,EAAE,sBAAsB;YAQ7B,mBAAmB;IAW3B,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,OAAO,EACjB,UAAU,CAAC,EAAE,CAAC,gBAAgB,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,GAClE,OAAO,CAAC,MAAM,CAAC;IA4FZ,wBAAwB,CAC5B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,QAAQ,CAAC;IAyDd,uBAAuB,CAC3B,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,IAAI,GAC9C,OAAO,CAAC,QAAQ,CAAC;IAkCd,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAKjE;;;;OAIG;IACG,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAgB9C,kBAAkB;IAmEhC;;;;;;;;OAQG;IACG,kBAAkB,CACtB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,CAAC,gBAAgB,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,EACnE,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC;IAoElB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,8BAA8B,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,gBAAgB,GAC5B,OAAO,CAAC,MAAM,CAAC;CA0FnB"}
+{"version":3,"file":"open-cloud-client.d.ts","sourceRoot":"","sources":["../../../src/utils/open-cloud/open-cloud-client.ts"],"names":[],"mappings":"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"}

package/dist/utils/open-cloud/open-cloud-client.js

@@ -3,6 +3,20 @@ import { Readable, Transform } from 'node:stream';
 import nodeFetch from 'node-fetch';
 import { OutputHelper } from '@quenty/cli-output-helpers';
 import { parseTestLogs, } from '../testing/test-log-parser.js';
+/**
+ * The values a finished task's script returned, or `undefined` when the task
+ * reported no result at all.
+ *
+ * The distinction matters: `undefined` means nothing came back to read, so a
+ * caller can fall back to the task's logs, while `[]` means the task did report
+ * a result and the script returned nothing — no fallback will find more.
+ */
+export function getTaskReturnValues(task) {
+    if (!task.output) {
+        return undefined;
+    }
+    return task.output.results ?? [];
+}
 function formatAuthError(action, scope, universeId, placeId, status, statusText, body, method, url) {
     // Extract human-readable message from JSON body if possible
     let apiMessage = '';
@@ -179,20 +193,29 @@ export class OpenCloudClient {
     }
     async getTaskLogsAsync(taskPath) {
         const raw = await this.getRawTaskLogsAsync(taskPath);
-        return parseTestLogs(raw);
+        return parseTestLogs(raw.text);
     }
     /**
-     * Fetch raw log text from a completed Luau execution task.
+     * Fetch raw log text from a completed Luau execution task, along with the
+     * shape of the fetch that produced it.
+     *
      * Retries a few times if the API returns empty logs, since the test runner
-     * always produces at least some output.
+     * always produces at least some output. The reported `requests` count spans
+     * every attempt, so a fetch that only filled in on its third try says so.
      */
     async getRawTaskLogsAsync(taskPath) {
         const maxAttempts = 3;
         const retryDelayMs = 1000;
+        let requests = 0;
         for (let attempt = 1; attempt <= maxAttempts; attempt++) {
-            const logs = await this._fetchRawLogsAsync(taskPath);
-            if (logs || attempt === maxAttempts) {
-                return logs;
+            const fetched = await this._fetchRawLogsAsync(taskPath);
+            requests += fetched.stats.requests;
+            if (fetched.text || attempt === maxAttempts) {
+                return {
+                    text: fetched.text,
+                    stats: { ...fetched.stats, requests },
+                    messages: fetched.messages,
+                };
             }
             await new Promise((resolve) => setTimeout(resolve, retryDelayMs));
         }
@@ -227,23 +250,36 @@ export class OpenCloudClient {
             const data = (await response.json());
             for (const entry of data.luauExecutionSessionTaskLogs ?? []) {
                 if (entry.structuredMessages?.length) {
-                    messages.push(...entry.structuredMessages.map((msg) => msg.message));
+                    messages.push(...entry.structuredMessages.map((msg) => ({
+                        message: msg.message,
+                        messageType: msg.messageType,
+                    })));
                 }
                 else if (entry.messages?.length) {
-                    messages.push(...entry.messages);
+                    // The flat view carries no severity, which stays absent rather than
+                    // being guessed at.
+                    messages.push(...entry.messages.map((message) => ({ message })));
                 }
             }
             entriesFetched += (data.luauExecutionSessionTaskLogs ?? []).length;
             pagesFetched++;
             pageToken = data.nextPageToken || undefined;
         } while (pageToken);
-        const text = messages.join('\n');
+        const text = messages.map((entry) => entry.message).join('\n');
+        const stats = {
+            requests: pagesFetched,
+            pages: pagesFetched,
+            entries: entriesFetched,
+            messages: messages.length,
+            chars: text.length,
+        };
         // Log volume is the prime suspect when engine output goes missing between
         // the task and the parser, and the parser cannot tell a short run from a
-        // truncated fetch. Record what arrived so a real run can settle it.
-        OutputHelper.verbose(`[open-cloud] Task logs: ${pagesFetched} page(s), ${entriesFetched} entries, ` +
-            `${messages.length} messages, ${text.length} chars`);
-        return text;
+        // truncated fetch. Handed out with the text rather than only printed, so
+        // the diagnostic that finds the output missing can say what the fetch saw.
+        OutputHelper.verbose(`[open-cloud] Task logs: ${stats.pages} page(s), ${stats.entries} entries, ` +
+            `${stats.messages} messages, ${stats.chars} chars`);
+        return { text, stats, messages };
     }
     /**
      * Download a place file via the Asset Delivery API.