orizu 0.3.4 → 0.3.5

package/README.md

@@ -169,6 +169,21 @@ orizu logout
   --output-schema ./schemas/support-output.json</code></pre>
     </td>
   </tr>
+  <tr>
+    <td>Preview an app locally</td>
+    <td>
+      <pre><code>orizu apps preview \
+  --file ./apps/SupportLabeler.tsx \
+  --input-schema ./schemas/support-input.json \
+  --output-schema ./schemas/support-output.json \
+  --sample-row ./fixtures/sample-row.json \
+  --screenshot ./preview.png</code></pre>
+    </td>
+  </tr>
+  <tr>
+    <td>Preview runtime</td>
+    <td>The CLI uses the live Orizu web checkout when it is nearby, otherwise it uses the bundled preview runtime snapshot shipped in this package.</td>
+  </tr>
   <tr>
     <td>Link a dataset to an app</td>
     <td><code>orizu apps link-dataset --app &lt;appId&gt; --dataset &lt;datasetId&gt;</code></td>

package/dist/index.js

@@ -14,6 +14,7 @@ import { parseDatasetFile } from './file-parser.js';
 import { streamJsonlRowChunks } from './jsonl-stream.js';
 import { parseDatasetReference } from './dataset-download.js';
 import { parseGlobalFlags } from './global-flags.js';
+import { runLocalAppPreview } from './preview-runtime.js';
 import { assertSecureTokenTransport, authedFetch, getBaseUrl, resolveLoginBaseUrl, setGlobalFlags, } from './http.js';
 import { formatTaskCreateError } from './task-create-error.js';
 const MAX_README_LENGTH = 200_000;
@@ -31,7 +32,11 @@ function printVersion() {
     printLine(`orizu ${getCliVersion()}`);
 }
 function printUsage() {
-    printLine(`orizu global options:\n\n  --local                 Use http://localhost:3000\n  --server <url>          Use a specific server origin (for example: https://preview.example.com)\n  --version, -v           Print the orizu CLI version\n\norizu commands:\n\n  orizu login [--no-prompt-if-logged-in]\n  orizu logout\n  orizu whoami\n  orizu env [--project <team/project>] [--project-id <projectId>]\n  orizu log <event_type> --run-id <id> --sequence <n> --payload @event.json\n  orizu teams list\n  orizu teams create [--name <name>]\n  orizu teams members list [--team <teamSlug>]\n  orizu teams members add --email <email> [--team <teamSlug>]\n  orizu teams members remove --email <email> [--team <teamSlug>]\n  orizu teams members role --team <teamSlug> --email <email> --role <admin|member>\n  orizu projects list [--team <teamSlug>]\n  orizu projects create --name <name> [--team <teamSlug>]\n  orizu prompts list --project <team/project>\n  orizu prompts comments <prompt-id-or-name> --project <team/project> [--label <label> | --version <id>] [--json]\n  orizu prompts pull <prompt-id-or-name> --project <team/project> --out <dir> [--label <label> | --version <id>] [--json]\n  orizu prompts push <dir> [--runner-version <id>] [--project <team/project>] [--parent <version-id>] [--json]\n  orizu prompts labels set <prompt-name> <label> --version <version-id> [--project <team/project>] [--json]\n  orizu prompts scorers set-headline <prompt-id> --scorer-version <id> [--dataset-version <id> --split-set <id> --split <name>] [--project <team/project>] [--json]\n  orizu prompts scorers add <prompt-id> --scorer-version <id> [--dataset-version <id> --split-set <id> --split <name>] [--project <team/project>] [--json]\n  orizu scorers list --project <team/project>\n  orizu scorers register --project <team/project> --name <name> --manifest <manifest.json> [--prompt-version <id>] [--runner-version <id>] [--label <label>] [--json]\n  orizu scorers detail <scorer-id-or-name> --project <team/project> [--json]\n  orizu scorers labels set <scorer-name> <label> --version <scorer-version-id> [--project <team/project>] [--json]\n  orizu scores submit <results.jsonl|results.json> --scorer-version <id> --subject-version <prompt-version-id> [--dataset-version <id> --split-set <id> --split <name>] [--project <team/project>] [--json]\n  orizu judges list --project <team/project>\n  orizu judges pull <judge-id-or-name> --project <team/project> --out <dir> [--label <label> | --version <id>] [--json]\n  orizu judges push <dir> [--runner-version <id>] [--project <team/project>] [--parent <version-id>] [--json]\n  orizu runners push <dir> [--project <team/project>] [--name <name>] [--label <label>] [--json]\n  orizu runners exec (--prompt <prompt-version-id> | --prompt-version <id> --runner-version <id> | --scorer-version <id>) --dataset-version <id> --split-set <id-or-name> --split <name> [--runner-dir <dir>] --out <results.jsonl|results.jsonl.gz>\n  orizu optimizers push <dir> [--project <team/project>] [--name <name>] [--label <label>] [--json]\n  orizu runs submit <results.jsonl|results.jsonl.gz> --prompt-version <id> --runner-version <id> --dataset-version <id> --split-set <id> --split <name> [--project <team/project>]\n  orizu apps list [--project <team/project>]\n  orizu apps create --project <team/project> --name <name> --dataset <datasetId> --file <path> --input-schema <json-path> --output-schema <json-path> [--component <name>]\n  orizu apps update [--app <appId>] [--project <team/project>] --file <path> --input-schema <json-path> --output-schema <json-path> [--component <name>]\n  orizu apps link-dataset --dataset <datasetId> [--app <appId>] [--project <team/project>] [--version <n>]\n  orizu apps detail --app <appId> [--project <team/project>] [--json]\n  orizu apps export [--app <appId>] [--project <team/project>] [--version <n>] [--out <path>]\n  orizu tasks list [--project <team/project>]\n  orizu tasks create --project <team/project> --dataset <datasetId> --app <appId> --title <title> --assignees <userIdOrEmail1,userIdOrEmail2> [--version <n>] [--instructions <text>] [--labels-per-item <n>] [--json]\n  orizu tasks assign --task <taskId> --assignees <userId1,userId2>\n  orizu tasks status --task <taskId> [--json]\n  orizu tasks pause --task <taskId>\n  orizu tasks unpause --task <taskId>\n  orizu datasets upload --file <path> [--project <team/project>] [--name <name>] [--readme-file <README.md> | --readme-text <markdown>]\n  orizu datasets push <path> [--project <team/project>] [--name <name>] [--readme-file <README.md> | --readme-text <markdown>] [--json]\n  orizu datasets readme set <datasetId|dataset-name> [--project <team/project>] (--readme-file <README.md> | --readme-text <markdown>) [--json]\n  orizu datasets versions create <datasetId|dataset-name> [--project <team/project>] [--label <label>] [--readme-file <README.md> | --readme-text <markdown>] [--json]\n  orizu datasets splits create <datasetVersionId> [--from-file <split.json>] [--json]\n  orizu datasets download [--dataset <datasetId|datasetUrl>] [--project <team/project>] [--format <csv|json|jsonl>] [--out <path>]\n  orizu datasets append [--dataset <datasetId|datasetUrl>] [--project <team/project>] --file <path>\n  orizu datasets edit-rows [--dataset <datasetId|datasetUrl>] [--project <team/project>] --file <path>\n  orizu datasets delete-rows [--dataset <datasetId|datasetUrl>] [--project <team/project>] --row-ids <id1,id2>\n  orizu datasets delete [--dataset <datasetId|datasetUrl>] [--project <team/project>]\n  orizu datasets lock [--dataset <datasetId|datasetUrl>] [--project <team/project>] [--reason <text>]\n  orizu datasets clone [--dataset <datasetId|datasetUrl>] [--project <team/project>] [--name <name>]\n  orizu tasks export [--task <taskId>] [--format <csv|json|jsonl>] [--out <path>]`);
+    printLine(`orizu global options:\n\n  --local                 Use http://localhost:3000\n  --server <url>          Use a specific server origin (for example: https://preview.example.com)\n  --version, -v           Print the orizu CLI version\n\norizu commands:\n\n  orizu login [--no-prompt-if-logged-in]\n  orizu logout\n  orizu whoami\n  orizu env [--project <team/project>] [--project-id <projectId>]\n  orizu log <event_type> --run-id <id> --sequence <n> --payload @event.json\n  orizu teams list\n  orizu teams create [--name <name>]\n  orizu teams members list [--team <teamSlug>]\n  orizu teams members add --email <email> [--team <teamSlug>]\n  orizu teams members remove --email <email> [--team <teamSlug>]\n  orizu teams members role --team <teamSlug> --email <email> --role <admin|member>\n  orizu projects list [--team <teamSlug>]\n  orizu projects create --name <name> [--team <teamSlug>]\n  orizu prompts list --project <team/project>\n  orizu prompts comments <prompt-id-or-name> --project <team/project> [--label <label> | --version <id>] [--json]\n  orizu prompts pull <prompt-id-or-name> --project <team/project> --out <dir> [--label <label> | --version <id>] [--json]\n  orizu prompts push <dir> [--runner-version <id>] [--project <team/project>] [--parent <version-id>] [--json]\n  orizu prompts labels set <prompt-name> <label> --version <version-id> [--project <team/project>] [--json]\n  orizu prompts scorers set-headline <prompt-id> --scorer-version <id> [--dataset-version <id> --split-set <id> --split <name>] [--project <team/project>] [--json]\n  orizu prompts scorers add <prompt-id> --scorer-version <id> [--dataset-version <id> --split-set <id> --split <name>] [--project <team/project>] [--json]\n  orizu scorers list --project <team/project>\n  orizu scorers register --project <team/project> --name <name> --manifest <manifest.json> [--prompt-version <id>] [--runner-version <id>] [--label <label>] [--json]\n  orizu scorers detail <scorer-id-or-name> --project <team/project> [--json]\n  orizu scorers labels set <scorer-name> <label> --version <scorer-version-id> [--project <team/project>] [--json]\n  orizu scorers exec --scorer-version <id> (--subject-version <prompt-version-id> | --optimization-run <id> --candidate <id>) --dataset-version <id> --split-set <id> --split <name> [--subject-results <jsonl>] [--dependency-score-run <alias=id>] [--dependency-results <alias=path>] [--no-submit] [--out <score.json>] [--project <team/project>] [--json]\n  orizu scores submit <results.jsonl|results.json> --scorer-version <id> (--subject-version <prompt-version-id> | --optimization-run <id> --candidate <id>) [--aggregate] [--dataset-version <id> --split-set <id> --split <name>] [--project <team/project>] [--json]\n  orizu judges list --project <team/project>\n  orizu judges pull <judge-id-or-name> --project <team/project> --out <dir> [--label <label> | --version <id>] [--json]\n  orizu judges push <dir> [--runner-version <id>] [--project <team/project>] [--parent <version-id>] [--json]\n  orizu runners push <dir> [--project <team/project>] [--name <name>] [--label <label>] [--json]\n  orizu runners exec (--prompt <prompt-version-id> | --prompt-version <id> --runner-version <id> | --scorer-version <id>) --dataset-version <id> --split-set <id-or-name> --split <name> [--runner-dir <dir>] --out <results.jsonl|results.jsonl.gz>\n  orizu optimizers push <dir> [--project <team/project>] [--name <name>] [--label <label>] [--json]\n  orizu runs submit <results.jsonl|results.jsonl.gz> --prompt-version <id> --runner-version <id> --dataset-version <id> --split-set <id> --split <name> [--project <team/project>]\n  orizu apps list [--project <team/project>]\n  orizu apps create --project <team/project> --name <name> --dataset <datasetId> --file <path> --input-schema <json-path> --output-schema <json-path> [--component <name>]\n  orizu apps update [--app <appId>] [--project <team/project>] --file <path> --input-schema <json-path> --output-schema <json-path> [--component <name>]\n  orizu apps link-dataset --dataset <datasetId> [--app <appId>] [--project <team/project>] [--version <n>]\n  orizu apps detail --app <appId> [--project <team/project>] [--json]\n  orizu apps export [--app <appId>] [--project <team/project>] [--version <n>] [--out <path>]\n  orizu tasks list [--project <team/project>]\n  orizu tasks create --project <team/project> --dataset <datasetId> --app <appId> --title <title> --assignees <userIdOrEmail1,userIdOrEmail2> [--version <n>] [--instructions <text>] [--labels-per-item <n>] [--json]\n  orizu tasks assign --task <taskId> --assignees <userId1,userId2>\n  orizu tasks status --task <taskId> [--json]\n  orizu tasks pause --task <taskId>\n  orizu tasks unpause --task <taskId>\n  orizu datasets upload --file <path> [--project <team/project>] [--name <name>] [--readme-file <README.md> | --readme-text <markdown>]\n  orizu datasets push <path> [--project <team/project>] [--name <name>] [--readme-file <README.md> | --readme-text <markdown>] [--json]\n  orizu datasets readme set <datasetId|dataset-name> [--project <team/project>] (--readme-file <README.md> | --readme-text <markdown>) [--json]\n  orizu datasets versions create <datasetId|dataset-name> [--project <team/project>] [--label <label>] [--readme-file <README.md> | --readme-text <markdown>] [--json]\n  orizu datasets splits create <datasetVersionId> [--from-file <split.json>] [--json]\n  orizu datasets download [--dataset <datasetId|datasetUrl>] [--project <team/project>] [--format <csv|json|jsonl>] [--out <path>]\n  orizu datasets append [--dataset <datasetId|datasetUrl>] [--project <team/project>] --file <path>\n  orizu datasets edit-rows [--dataset <datasetId|datasetUrl>] [--project <team/project>] --file <path>\n  orizu datasets delete-rows [--dataset <datasetId|datasetUrl>] [--project <team/project>] --row-ids <id1,id2>\n  orizu datasets delete [--dataset <datasetId|datasetUrl>] [--project <team/project>]\n  orizu datasets lock [--dataset <datasetId|datasetUrl>] [--project <team/project>] [--reason <text>]\n  orizu datasets clone [--dataset <datasetId|datasetUrl>] [--project <team/project>] [--name <name>]\n  orizu tasks export [--task <taskId>] [--format <csv|json|jsonl>] [--out <path>]`);
+    printPreviewUsage();
+}
+function printPreviewUsage() {
+    printLine(`\nLocal app preview:\n\n  orizu apps preview --file <path> --input-schema <json-path> --output-schema <json-path> --sample-row <json-path> [--screenshot <png-path>] [--headed] [--keep-open] [--component <name>]`);
 }
 function printOptimizationUsage() {
     printLine(`\nOptimization lifecycle commands:\n\n  orizu optimizations start --project <team/project> --optimizer-version <id> --prompt-version <id[,id]> --selection-scorer <id> [--reflection-scorer <id>] [--pareto-scorer <id>] [--best-scorer <id>] --dataset-version <id> --split-set <id> [--train-split <name>] [--validation-split <name>] [--metadata <json|@file>] [--json]\n  orizu optimizations run-gepa --project <team/project> --optimizer-version-id <id> --candidate-version-id <id> --runner-version-id <id> --candidate-runner-dir <dir> --scorer-version-id <id> --scorer-runner-version-id <id> --scorer-runner-dir <dir> --dataset-version-id <id> --split-set-id <id> [--train-split train] [--val-split validation] [--log-dir logs]\n  orizu optimizations export <run-id> [--out <path>] [--json]\n  orizu optimizations pause <run-id> [--reason <text>] [--json]\n  orizu optimizations resume <run-id> [--json]\n  orizu optimizations finish <run-id> [--best-score <n>] [--best-candidate <id>] [--result-prompt-version <id>] [--report <markdown|@file> | --report-file <path>] [--metadata <json|@file>] [--json]\n  orizu optimizations fail <run-id> [--reason <text>] [--report <markdown|@file> | --report-file <path>] [--metadata <json|@file>] [--json]\n  orizu optimizations cancel <run-id> [--reason <text>] [--report <markdown|@file> | --report-file <path>] [--json]`);
@@ -1384,17 +1389,22 @@ async function submitScoreResults() {
     const optimizationRunId = getArg('--optimization-run');
     const candidateId = getArg('--candidate');
     if (!resultsPath || !scorerVersionId || (!subjectPromptVersionId && (!optimizationRunId || !candidateId))) {
-        throw new Error('Usage: orizu scores submit <results.jsonl|results.json> --project <team/project> --scorer-version <id> (--subject-version <prompt-version-id> | --optimization-run <id> --candidate <id>) [--dataset-version <id> --split-set <id> --split <name>] [--json]');
+        throw new Error('Usage: orizu scores submit <results.jsonl|results.json> --project <team/project> --scorer-version <id> (--subject-version <prompt-version-id> | --optimization-run <id> --candidate <id>) [--aggregate] [--dataset-version <id> --split-set <id> --split <name>] [--json]');
     }
     const resultBytes = readSourceBytes(resultsPath);
     const raw = resultsPath.endsWith('.gz')
         ? gunzipSync(resultBytes).toString('utf8')
         : resultBytes.toString('utf8');
-    const resultsJsonl = normalizeScoreResultsInput(resultsPath, raw);
+    const scoreInput = normalizeScoreResultsInput(resultsPath, raw, hasArg('--aggregate'));
+    if (scoreInput.aggregateWarning) {
+        console.warn(scoreInput.aggregateWarning);
+    }
+    const aggregatePayload = scoreInput.aggregate || {};
     const response = await authedFetch(`/api/cli/scores/submit?project=${encodeURIComponent(project)}`, {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
         body: JSON.stringify({
+            ...aggregatePayload,
             scorerVersionId,
             subjectPromptVersionId: subjectPromptVersionId || undefined,
             datasetVersionId: getArg('--dataset-version') || undefined,
@@ -1402,7 +1412,7 @@ async function submitScoreResults() {
             splitName: getArg('--split') || undefined,
             optimizationRunId: optimizationRunId || undefined,
             candidateId: candidateId || undefined,
-            resultsJsonl,
+            resultsJsonl: scoreInput.resultsJsonl,
         }),
     });
     if (!response.ok) {
@@ -1416,23 +1426,149 @@ async function submitScoreResults() {
     printLine(`Submitted score ${sanitizeTerminalText(data.scoreRun.id)} ` +
         `(${formatPercent(data.scoreRun.scoreValue)})`);
 }
-function normalizeScoreResultsInput(sourcePath, raw) {
+function looksLikeAggregateScoreObject(value) {
+    return (value.scoreValue !== undefined ||
+        value.score_value !== undefined ||
+        value.diagnostics !== undefined ||
+        value.feedbackSummary !== undefined ||
+        value.feedback_summary !== undefined ||
+        value.rowEvidence !== undefined ||
+        value.row_evidence !== undefined ||
+        value.dependencyScoreRunIds !== undefined ||
+        value.dependency_score_run_ids !== undefined);
+}
+function numberFromUnknown(value) {
+    if (typeof value === 'number' && Number.isFinite(value))
+        return value;
+    if (typeof value === 'string' && value.trim()) {
+        const parsed = Number(value);
+        return Number.isFinite(parsed) ? parsed : null;
+    }
+    if (typeof value === 'boolean')
+        return value ? 1 : 0;
+    return null;
+}
+function normalizeScoreResultsInput(sourcePath, raw, aggregateMode = false) {
     const logicalPath = sourcePath.endsWith('.gz') ? sourcePath.slice(0, -3) : sourcePath;
     if (!logicalPath.endsWith('.json'))
-        return raw;
+        return { resultsJsonl: raw };
     try {
         const parsed = JSON.parse(raw);
+        if (aggregateMode) {
+            if (!isRecord(parsed)) {
+                throw new Error('Aggregate score results JSON must be an object');
+            }
+            return { aggregate: parsed };
+        }
+        if (isRecord(parsed) && looksLikeAggregateScoreObject(parsed)) {
+            return {
+                aggregate: parsed,
+                aggregateWarning: 'Warning: aggregate score JSON detected. Pass --aggregate to make this explicit.',
+            };
+        }
         const rows = Array.isArray(parsed) ? parsed : [parsed];
         if (rows.some(row => !isRecord(row))) {
             throw new Error('JSON score results must be an object or an array of objects');
         }
-        return rows.map(row => JSON.stringify(row)).join('\n');
+        return { resultsJsonl: rows.map(row => JSON.stringify(row)).join('\n') };
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);
         throw new Error(`Invalid score results JSON '${sourcePath}': ${message}`);
     }
 }
+function readOptionalJsonlFile(pathArg) {
+    if (!pathArg)
+        return undefined;
+    const bytes = readSourceBytes(pathArg);
+    return pathArg.endsWith('.gz')
+        ? gunzipSync(bytes).toString('utf8')
+        : bytes.toString('utf8');
+}
+function parseAliasAssignments(value) {
+    const result = {};
+    if (!value)
+        return result;
+    for (const item of parseCommaSeparated(value)) {
+        const equalsIndex = item.indexOf('=');
+        if (equalsIndex <= 0 || equalsIndex === item.length - 1) {
+            throw new Error(`Expected alias assignment in form alias=value, got '${item}'`);
+        }
+        result[item.slice(0, equalsIndex)] = item.slice(equalsIndex + 1);
+    }
+    return result;
+}
+function readDependencyResultAssignments(value) {
+    const assignments = parseAliasAssignments(value);
+    const result = {};
+    for (const [alias, path] of Object.entries(assignments)) {
+        result[alias] = readOptionalJsonlFile(path) || '';
+    }
+    return Object.keys(result).length > 0 ? result : undefined;
+}
+async function execScorer() {
+    const project = getArg('--project') || await resolveProjectSlug(null);
+    const scorerVersionId = getArg('--scorer-version');
+    const subjectPromptVersionId = getArg('--subject-version') || getArg('--prompt-version');
+    const optimizationRunId = getArg('--optimization-run');
+    const candidateId = getArg('--candidate');
+    const datasetVersionId = getArg('--dataset-version');
+    const splitSetId = getArg('--split-set');
+    const splitName = getArg('--split');
+    const outPath = getArg('--out');
+    if (!scorerVersionId ||
+        (!subjectPromptVersionId && (!optimizationRunId || !candidateId)) ||
+        !datasetVersionId ||
+        !splitSetId ||
+        !splitName) {
+        throw new Error('Usage: orizu scorers exec --scorer-version <id> (--subject-version <prompt-version-id> | --optimization-run <id> --candidate <id>) --dataset-version <id> --split-set <id> --split <name> [--subject-results <jsonl>] [--dependency-score-run <alias=id>] [--dependency-results <alias=path>] [--no-submit] [--out <score.json>] [--project <team/project>] [--json]');
+    }
+    const response = await authedFetch(`/api/cli/scorers/exec?project=${encodeURIComponent(project)}`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            scorerVersionId,
+            subjectPromptVersionId: subjectPromptVersionId || undefined,
+            optimizationRunId: optimizationRunId || undefined,
+            candidateId: candidateId || undefined,
+            datasetVersionId,
+            splitSetId,
+            splitName,
+            submit: !hasArg('--no-submit'),
+            reuseExisting: !hasArg('--no-reuse-existing'),
+            subjectResultsJsonl: readOptionalJsonlFile(getArg('--subject-results') || getArg('--outputs')),
+            dependencyScoreRunIds: parseAliasAssignments(getArg('--dependency-score-run') || getArg('--dependency-score-runs')),
+            dependencyResultsJsonl: readDependencyResultAssignments(getArg('--dependency-results')),
+        }),
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to execute scorer: ${await response.text()}`);
+    }
+    const data = await parseJsonResponse(response, 'Scorer exec');
+    if (outPath) {
+        writeFileSync(expandHomePath(outPath), `${JSON.stringify(data.scoreResult || data, null, 2)}\n`);
+    }
+    if (hasJsonFlag()) {
+        printJson(data);
+        return;
+    }
+    const scoreRun = isRecord(data.scoreRun) ? data.scoreRun : null;
+    const scoreResult = isRecord(data.scoreResult) ? data.scoreResult : null;
+    const scoreValue = scoreRun
+        ? scoreRun.scoreValue
+        : scoreResult
+            ? scoreResult.scoreValue
+            : null;
+    if (scoreRun && typeof scoreRun.id === 'string') {
+        printLine(`Executed scorer ${sanitizeTerminalText(scorerVersionId)} -> score ${sanitizeTerminalText(scoreRun.id)} (${formatPercent(numberFromUnknown(scoreValue))})`);
+    }
+    else {
+        printLine(`Executed scorer ${sanitizeTerminalText(scorerVersionId)} (${formatPercent(numberFromUnknown(scoreValue))})`);
+    }
+    if (outPath) {
+        printLine(`Wrote scorer result to ${sanitizeTerminalText(outPath)}`);
+    }
+}
 const OPTIMIZATION_REPORT_MAX_BYTES = 2 * 1024 * 1024;
 function parseOptionalNumberFlag(name) {
     const value = getArg(name);
@@ -2020,10 +2156,51 @@ async function createAppFromFile() {
     }
     const data = await parseJsonResponse(response, 'App create');
     printLine(`Created app ${sanitizeTerminalText(data.app.name)} (${sanitizeTerminalText(data.app.id)}) v${data.app.versionNum}`);
+    if (data.app.url) {
+        printLine(`View app: ${formatTerminalLink(data.app.url)}`);
+    }
     if (data.warnings?.length) {
         printLine(`Warnings: ${sanitizeTerminalText(data.warnings.join('; '))}`);
     }
 }
+async function previewAppFromFile() {
+    const filePath = getArg('--file');
+    const inputSchemaPath = getArg('--input-schema');
+    const outputSchemaPath = getArg('--output-schema');
+    const sampleRowPath = getArg('--sample-row');
+    const screenshotPath = getArg('--screenshot');
+    const component = getArg('--component') || undefined;
+    const headed = hasArg('--headed');
+    const keepOpen = hasArg('--keep-open');
+    if (!filePath || !inputSchemaPath || !outputSchemaPath || !sampleRowPath) {
+        throw new Error('Usage: orizu apps preview --file <path> --input-schema <json-path> --output-schema <json-path> --sample-row <json-path> [--screenshot <png-path>] [--headed] [--keep-open] [--component <name>]');
+    }
+    const expandedFilePath = realpathSync(expandHomePath(filePath));
+    const inputJsonSchema = readJsonFile(inputSchemaPath);
+    const outputJsonSchema = readJsonFile(outputSchemaPath);
+    const sampleRow = readJsonFile(sampleRowPath);
+    const expandedScreenshotPath = screenshotPath ? expandHomePath(screenshotPath) : undefined;
+    const result = await runLocalAppPreview({
+        filePath: expandedFilePath,
+        inputSchema: inputJsonSchema,
+        outputSchema: outputJsonSchema,
+        sampleRow,
+        screenshotPath: expandedScreenshotPath,
+        componentName: component,
+        headed,
+        keepOpen,
+    });
+    printLine(`Preview rendered: ${formatTerminalLink(result.url)}`);
+    if (result.screenshotPath) {
+        printLine(`Screenshot: ${sanitizeTerminalText(result.screenshotPath)}`);
+    }
+    if (headed || keepOpen) {
+        printLine('Headed preview is running. Close Chromium or stop the command when you are done.');
+    }
+    if (result.warnings.length > 0) {
+        printLine(`Warnings: ${sanitizeTerminalText(result.warnings.join('; '))}`);
+    }
+}
 async function updateAppFromFile() {
     const filePath = getArg('--file');
     const inputSchemaPath = getArg('--input-schema');
@@ -3240,6 +3417,10 @@ export async function main(rawArgs = process.argv.slice(2)) {
         await setScorerLabel();
         return;
     }
+    if (command === 'scorers' && subcommand === 'exec') {
+        await execScorer();
+        return;
+    }
     if (command === 'runners' && subcommand === 'push') {
         await pushRunnerArtifact('runner');
         return;
@@ -3289,6 +3470,10 @@ export async function main(rawArgs = process.argv.slice(2)) {
         await createAppFromFile();
         return;
     }
+    if (command === 'apps' && subcommand === 'preview') {
+        await previewAppFromFile();
+        return;
+    }
     if (command === 'apps' && subcommand === 'update') {
         await updateAppFromFile();
         return;