orizu 0.5.33 → 0.5.35

package/dist/app-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-commands.d.ts","sourceRoot":"","sources":["../src/app-commands.ts"],"names":[],"mappings":"AAiCA,iBAAe,QAAQ,kBAQtB;AAED,iBAAS,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAU/C;AAED,iBAAS,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAUhD;AAED,iBAAS,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAY9D;AAED,iBAAS,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAElE;AAED,iBAAS,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG1F;AAED,iBAAS,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUjE;AAED,iBAAS,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAEjD;AAED,iBAAS,qBAAqB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG;IACpF,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;CACb,CAeA;AAED,iBAAS,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,MAAM;;;;;IAoB/E;AAED,iBAAS,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,QAGjE;AAED,iBAAS,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEjE;AAED,iBAAe,iBAAiB,kBAiD/B;AAED,iBAAe,kBAAkB,kBAiDhC;AAED,iBAAe,iBAAiB,kBA+C/B;AAED,iBAAe,cAAc,kBAgD5B;AA+CD,iBAAe,SAAS,kBA2CvB;AAED,yFAAyF;AACzF,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAK3G;AAED,iBAAe,eAAe,kBAmD7B;AAED,OAAO,EACL,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,EACR,gBAAgB,EAChB,wBAAwB,EACxB,SAAS,EACT,eAAe,EACf,QAAQ,EACR,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,SAAS,EACT,eAAe,GAChB,CAAA"}
+{"version":3,"file":"app-commands.d.ts","sourceRoot":"","sources":["../src/app-commands.ts"],"names":[],"mappings":"AAkCA,iBAAe,QAAQ,kBActB;AAED,iBAAS,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAU/C;AAED,iBAAS,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAUhD;AAED,iBAAS,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAY9D;AAED,iBAAS,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAElE;AAED,iBAAS,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG1F;AAED,iBAAS,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUjE;AAED,iBAAS,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAEjD;AAED,iBAAS,qBAAqB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG;IACpF,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;CACb,CAeA;AAED,iBAAS,kBAAkB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,MAAM;;;;;IAoB/E;AAED,iBAAS,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,QAGjE;AAED,iBAAS,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEjE;AAED,iBAAe,iBAAiB,kBAiD/B;AAED,iBAAe,kBAAkB,kBAiDhC;AAED,iBAAe,iBAAiB,kBAiD/B;AAED,iBAAe,cAAc,kBAgD5B;AA+CD,iBAAe,SAAS,kBA2CvB;AAED,yFAAyF;AACzF,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAK3G;AAED,iBAAe,eAAe,kBAmD7B;AAED,OAAO,EACL,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,EACR,gBAAgB,EAChB,wBAAwB,EACxB,SAAS,EACT,eAAe,EACf,QAAQ,EACR,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,SAAS,EACT,eAAe,GAChB,CAAA"}

package/dist/app-commands.js

@@ -7,17 +7,24 @@ import { resolveProjectSlug, fetchApps, selectAppIdInteractively } from './accou
 import { printJson, printLine, getErrorMessage } from './cli-console-output.js';
 import { printAppSummaries } from './archive-artifacts-cli.js';
 import { isNodeError, formatTerminalLink } from './auth-commands.js';
-import { authedFetch } from './http.js';
-import { parseJsonResponse, sanitizeTerminalText } from './json-response.js';
+import { authedFetch, getBaseUrl } from './http.js';
+import { appPageUrl } from './app-page-url.js';
+import { parseJsonResponse, sanitizeHumanInlineText, sanitizeTerminalText } from './json-response.js';
 import { runLocalAppPreview } from './preview-runtime.js';
 async function listApps() {
     const project = getArg('--project') || await resolveProjectSlug(null);
-    const apps = await fetchApps(project, getArchiveListStatus('apps'));
+    const baseUrl = getBaseUrl();
+    const apps = (await fetchApps(project, getArchiveListStatus('apps')))
+        .map(app => ({ ...app, pageUrl: appPageUrl(baseUrl, app.id) }));
     if (hasJsonFlag()) {
         printJson({ apps });
         return;
     }
     printAppSummaries(apps, printLine);
+    // An archived app's page still renders as if live, so it gets no link line.
+    apps
+        .filter(app => app.status !== 'archived')
+        .forEach(app => printLine(`Link: ${sanitizeHumanInlineText(sanitizeTerminalText, app.name || app.id)} ${formatTerminalLink(app.pageUrl)}`));
 }
 function readSourceFile(pathArg) {
     const expandedPath = expandHomePath(pathArg);
@@ -152,7 +159,7 @@ async function createAppFromFile() {
     }
     const data = await parseJsonResponse(response, 'App create');
     if (hasJsonFlag()) {
-        printJson({ app: data.app, warnings: data.warnings || [] });
+        printJson({ app: { ...data.app, pageUrl: data.app.url || appPageUrl(getBaseUrl(), data.app.id) }, warnings: data.warnings || [] });
         return;
     }
     printLine(`Created app ${sanitizeTerminalText(data.app.name)} (${sanitizeTerminalText(data.app.id)}) v${data.app.versionNum}`);
@@ -240,11 +247,13 @@ async function updateAppFromFile() {
         throw new Error(`Failed to update app: ${await response.text()}`);
     }
     const data = await parseJsonResponse(response, 'App update');
+    const pageUrl = appPageUrl(getBaseUrl(), data.app.id);
     if (hasJsonFlag()) {
-        printJson({ app: data.app, warnings: data.warnings || [] });
+        printJson({ app: { ...data.app, pageUrl }, warnings: data.warnings || [] });
         return;
     }
     printLine(`Updated app ${sanitizeTerminalText(data.app.name)} (${sanitizeTerminalText(data.app.id)}) to v${data.app.versionNum}`);
+    printLine(`View app: ${formatTerminalLink(pageUrl)}`);
     if (data.warnings?.length) {
         printLine(`Warnings: ${sanitizeTerminalText(data.warnings.join('; '))}`);
     }

package/dist/app-page-url.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Where an app's page lives in the web app (ORI-2342): `/preview/<app id>`,
+ * the route in apps/web/app/preview/[id]/page.tsx. `orizu apps list`,
+ * `orizu apps update` and the hosted agent's prompt build their links from
+ * here. `orizu apps create` prints the link the server returns instead.
+ */
+export declare function appPagePath(appId: string): string;
+export declare function appPageUrl(baseUrl: string, appId: string): string;
+//# sourceMappingURL=app-page-url.d.ts.map

package/dist/app-page-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-page-url.d.ts","sourceRoot":"","sources":["../src/app-page-url.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjE"}

package/dist/app-page-url.js

@@ -0,0 +1,12 @@
+/**
+ * Where an app's page lives in the web app (ORI-2342): `/preview/<app id>`,
+ * the route in apps/web/app/preview/[id]/page.tsx. `orizu apps list`,
+ * `orizu apps update` and the hosted agent's prompt build their links from
+ * here. `orizu apps create` prints the link the server returns instead.
+ */
+export function appPagePath(appId) {
+    return `/preview/${appId}`;
+}
+export function appPageUrl(baseUrl, appId) {
+    return `${baseUrl.replace(/\/+$/, '')}${appPagePath(encodeURIComponent(appId))}`;
+}

package/dist/archive-artifacts-cli.js

@@ -7,7 +7,7 @@
  */
 import { authedFetch } from './http.js';
 import { extractErrorMessage } from './error-response.js';
-import { sanitizeTerminalText } from './json-response.js';
+import { sanitizeHumanInlineText, sanitizeTerminalText } from './json-response.js';
 const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 const ARTIFACT_TYPES = {
     app: 'app',
@@ -61,7 +61,7 @@ export function printAppSummaries(items, print) {
         return print('No apps found.');
     printTable(['APP ID', 'APP NAME', 'VERSION', 'ARCHIVE'], items.map(item => [
         sanitizeTerminalText(item.id),
-        sanitizeTerminalText(item.name || '-'),
+        sanitizeHumanInlineText(sanitizeTerminalText, item.name || '-'),
         `v${item.currentVersionNum || 1}`,
         sanitizeTerminalText(item.status || 'active'),
     ]), print);

package/dist/hosted-agent-prompt.d.ts

@@ -1,14 +1,3 @@
-/**
- * The system prompt for the hosted agent (ORI-2207).
- *
- * OpenCode (the program that runs the agent in a hosted session) ships its own
- * built-in prompt that starts "You are opencode, an interactive CLI tool…", so
- * the agent used to introduce itself as OpenCode. We register our own "primary
- * agent" in the OpenCode config with this text, and every prompt request picks
- * it by name. That replaces OpenCode's built-in prompt entirely, so this text
- * carries the working rules we still want: use the tools, keep answers short.
- * AGENTS.md is still added after it, as before.
- */
 export declare const HOSTED_AGENT_NAME = "orizu";
-export declare const HOSTED_AGENT_PROMPT = "You are the Orizu agent. You work in the person's repository inside an Orizu workbench, helping them with software engineering tasks. If asked who or what you are, say you are the Orizu agent. Never call yourself OpenCode.\n\n- Do the work with your tools: read files, search, edit, and run commands. Do not guess at what a file contains when you can look.\n- Keep answers short and plain. Say what you did and what the person needs to know next.\n- Follow the repository's own conventions and any instructions in its AGENTS.md.";
+export declare const HOSTED_AGENT_PROMPT: string;
 //# sourceMappingURL=hosted-agent-prompt.d.ts.map

package/dist/hosted-agent-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hosted-agent-prompt.d.ts","sourceRoot":"","sources":["../src/hosted-agent-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,UAAU,CAAA;AAExC,eAAO,MAAM,mBAAmB,qhBAIiD,CAAA"}
+{"version":3,"file":"hosted-agent-prompt.d.ts","sourceRoot":"","sources":["../src/hosted-agent-prompt.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,iBAAiB,UAAU,CAAA;AAExC,eAAO,MAAM,mBAAmB,QAK4Z,CAAA"}

package/dist/hosted-agent-prompt.js

@@ -9,9 +9,11 @@
  * carries the working rules we still want: use the tools, keep answers short.
  * AGENTS.md is still added after it, as before.
  */
+import { appPagePath } from './app-page-url.js';
 export const HOSTED_AGENT_NAME = 'orizu';
 export const HOSTED_AGENT_PROMPT = `You are the Orizu agent. You work in the person's repository inside an Orizu workbench, helping them with software engineering tasks. If asked who or what you are, say you are the Orizu agent. Never call yourself OpenCode.
 
 - Do the work with your tools: read files, search, edit, and run commands. Do not guess at what a file contains when you can look.
 - Keep answers short and plain. Say what you did and what the person needs to know next.
-- Follow the repository's own conventions and any instructions in its AGENTS.md.`;
+- Follow the repository's own conventions and any instructions in its AGENTS.md.
+- An Orizu app's page link is <Orizu server>${appPagePath('<app id>')}, where <Orizu server> is the server the orizu CLI talks to (https://app.orizu.ai by default). To give someone an app's link, run \`orizu projects list\` to get the \`<team>/<project>\` slug, then \`orizu apps list --project <team>/<project>\`: it prints each app's full link. The --project flag is required here: prompts cannot run in this environment. Never guess a link.`;

package/dist/preview-runtime.d.ts

@@ -64,7 +64,12 @@ export declare function runLocalAppPreview(options: AppPreviewOptions): Promise<
  * an actionable message instead. Exported for tests.
  */
 export declare function findMissingPreviewRuntimeDeps(nodeModuleDirs: string[]): string[];
-export declare function buildPreviewCss(repoRoot: string | null, appPath: string): Promise<string>;
+declare function loadPreviewCssModules(): Promise<{
+    postcss: typeof import("postcss").default;
+    tailwind: import("postcss/lib/postcss").PluginCreator<import("@tailwindcss/postcss").PluginOptions>;
+}>;
+/** `loadModules` is for tests: one that fails stands in for a broken install. */
+export declare function buildPreviewCss(repoRoot: string | null, appPath: string, loadModules?: typeof loadPreviewCssModules): Promise<string>;
 export declare function getPreviewSnapshotModulePaths(): string[];
 export {};
 //# sourceMappingURL=preview-runtime.d.ts.map

package/dist/preview-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preview-runtime.d.ts","sourceRoot":"","sources":["../src/preview-runtime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"preview-runtime.d.ts","sourceRoot":"","sources":["../src/preview-runtime.ts"],"names":[],"mappings":"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"}

package/dist/preview-runtime.js

@@ -130,7 +130,6 @@ export async function runLocalAppPreview(options) {
     const cssPath = join(tempDir, 'preview.css');
     const htmlPath = join(tempDir, 'index.html');
     const outDir = join(tempDir, 'dist');
-    writeFileSync(cssPath, await buildPreviewCss(repoRoot, appPath), 'utf8');
     writeFileSync(entryPath, buildEntrySource(appPath, options.sampleRow), 'utf8');
     writeFileSync(htmlPath, buildPreviewHtml(), 'utf8');
     let server = null;
@@ -149,6 +148,8 @@ export async function runLocalAppPreview(options) {
                 '(run inside a project that has them, `npm install react react-dom` next to your app, ' +
                 'or run from an Orizu checkout after `bun install`).');
         }
+        // After the dependency checks, so their actionable errors come before a Tailwind warning.
+        writeFileSync(cssPath, await buildPreviewCss(repoRoot, appPath), 'utf8');
         await esbuild.build({
             entryPoints: [entryPath],
             bundle: true,
@@ -550,11 +551,15 @@ function buildPreviewHtml() {
 </html>
 `;
 }
-export async function buildPreviewCss(repoRoot, appPath) {
+const PREVIEW_TAILWIND_FALLBACK_WARNING = 'Tailwind CSS could not be built; the preview uses fallback styles';
+async function loadPreviewCssModules() {
+    return { postcss: (await import('postcss')).default, tailwind: (await import('@tailwindcss/postcss')).default };
+}
+/** `loadModules` is for tests: one that fails stands in for a broken install. */
+export async function buildPreviewCss(repoRoot, appPath, loadModules = loadPreviewCssModules) {
     const fallbackCss = buildPreviewChromeCss();
     try {
-        const postcss = (await import('postcss')).default;
-        const tailwind = (await import('@tailwindcss/postcss')).default;
+        const { postcss, tailwind } = await loadModules();
         const cliPackageRoot = findCliPackageRoot();
         const globalsPath = repoRoot
             ? join(repoRoot, 'app', 'globals.css')
@@ -576,7 +581,10 @@ export async function buildPreviewCss(repoRoot, appPath) {
         const result = await postcss([tailwind()]).process(sourceCss, { from: globalsPath });
         return result.css;
     }
-    catch {
+    catch (error) {
+        // Without Tailwind the screenshot loses the app's utility styling, so say so
+        // instead of looking right (ORI-2261: the sandbox tools check fails on it).
+        process.stderr.write(`warning: ${PREVIEW_TAILWIND_FALLBACK_WARNING} (${error instanceof Error ? error.message : String(error)})\n`);
         return fallbackCss;
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orizu",
-  "version": "0.5.33",
+  "version": "0.5.35",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",

package/src/app-commands.ts

@@ -25,20 +25,27 @@ import { resolveProjectSlug, fetchApps, selectAppIdInteractively } from './accou
 import { printJson, printLine, getErrorMessage } from './cli-console-output.js'
 import { printAppSummaries } from './archive-artifacts-cli.js'
 import { isNodeError, formatTerminalLink } from './auth-commands.js'
-import { authedFetch } from './http.js'
-import { parseJsonResponse, sanitizeTerminalText } from './json-response.js'
+import { authedFetch, getBaseUrl } from './http.js'
+import { appPageUrl } from './app-page-url.js'
+import { parseJsonResponse, sanitizeHumanInlineText, sanitizeTerminalText } from './json-response.js'
 import { runLocalAppPreview } from './preview-runtime.js'
 
 
 
 async function listApps() {
   const project = getArg('--project') || await resolveProjectSlug(null)
-  const apps = await fetchApps(project, getArchiveListStatus('apps'))
+  const baseUrl = getBaseUrl()
+  const apps = (await fetchApps(project, getArchiveListStatus('apps')))
+    .map(app => ({ ...app, pageUrl: appPageUrl(baseUrl, app.id) }))
   if (hasJsonFlag()) {
     printJson({ apps })
     return
   }
   printAppSummaries(apps, printLine)
+  // An archived app's page still renders as if live, so it gets no link line.
+  apps
+    .filter(app => app.status !== 'archived')
+    .forEach(app => printLine(`Link: ${sanitizeHumanInlineText(sanitizeTerminalText, app.name || app.id)} ${formatTerminalLink(app.pageUrl)}`))
 }
 
 function readSourceFile(pathArg: string): string {
@@ -195,7 +202,7 @@ async function createAppFromFile() {
     warnings?: string[]
   }>(response, 'App create')
   if (hasJsonFlag()) {
-    printJson({ app: data.app, warnings: data.warnings || [] })
+    printJson({ app: { ...data.app, pageUrl: data.app.url || appPageUrl(getBaseUrl(), data.app.id) }, warnings: data.warnings || [] })
     return
   }
   printLine(`Created app ${sanitizeTerminalText(data.app.name)} (${sanitizeTerminalText(data.app.id)}) v${data.app.versionNum}`)
@@ -297,11 +304,13 @@ async function updateAppFromFile() {
     app: { id: string; name: string; versionNum: number; componentName?: string }
     warnings?: string[]
   }>(response, 'App update')
+  const pageUrl = appPageUrl(getBaseUrl(), data.app.id)
   if (hasJsonFlag()) {
-    printJson({ app: data.app, warnings: data.warnings || [] })
+    printJson({ app: { ...data.app, pageUrl }, warnings: data.warnings || [] })
     return
   }
   printLine(`Updated app ${sanitizeTerminalText(data.app.name)} (${sanitizeTerminalText(data.app.id)}) to v${data.app.versionNum}`)
+  printLine(`View app: ${formatTerminalLink(pageUrl)}`)
   if (data.warnings?.length) {
     printLine(`Warnings: ${sanitizeTerminalText(data.warnings.join('; '))}`)
   }

package/src/app-page-url.ts

@@ -0,0 +1,13 @@
+/**
+ * Where an app's page lives in the web app (ORI-2342): `/preview/<app id>`,
+ * the route in apps/web/app/preview/[id]/page.tsx. `orizu apps list`,
+ * `orizu apps update` and the hosted agent's prompt build their links from
+ * here. `orizu apps create` prints the link the server returns instead.
+ */
+export function appPagePath(appId: string): string {
+  return `/preview/${appId}`
+}
+
+export function appPageUrl(baseUrl: string, appId: string): string {
+  return `${baseUrl.replace(/\/+$/, '')}${appPagePath(encodeURIComponent(appId))}`
+}

package/src/archive-artifacts-cli.ts

@@ -8,7 +8,7 @@
 
 import { authedFetch } from './http.js'
 import { extractErrorMessage } from './error-response.js'
-import { sanitizeTerminalText } from './json-response.js'
+import { sanitizeHumanInlineText, sanitizeTerminalText } from './json-response.js'
 
 type ArchiveStatus = 'active' | 'archived' | 'all'
 type ArchiveAction = 'archive' | 'restore'
@@ -148,7 +148,7 @@ export function printAppSummaries(items: AppSummary[], print: PrintLine) {
     ['APP ID', 'APP NAME', 'VERSION', 'ARCHIVE'],
     items.map(item => [
       sanitizeTerminalText(item.id),
-      sanitizeTerminalText(item.name || '-'),
+      sanitizeHumanInlineText(sanitizeTerminalText, item.name || '-'),
       `v${item.currentVersionNum || 1}`,
       sanitizeTerminalText(item.status || 'active'),
     ]),

package/src/hosted-agent-prompt.ts

@@ -9,10 +9,13 @@
  * carries the working rules we still want: use the tools, keep answers short.
  * AGENTS.md is still added after it, as before.
  */
+import { appPagePath } from './app-page-url.js'
+
 export const HOSTED_AGENT_NAME = 'orizu'
 
 export const HOSTED_AGENT_PROMPT = `You are the Orizu agent. You work in the person's repository inside an Orizu workbench, helping them with software engineering tasks. If asked who or what you are, say you are the Orizu agent. Never call yourself OpenCode.
 
 - Do the work with your tools: read files, search, edit, and run commands. Do not guess at what a file contains when you can look.
 - Keep answers short and plain. Say what you did and what the person needs to know next.
-- Follow the repository's own conventions and any instructions in its AGENTS.md.`
+- Follow the repository's own conventions and any instructions in its AGENTS.md.
+- An Orizu app's page link is <Orizu server>${appPagePath('<app id>')}, where <Orizu server> is the server the orizu CLI talks to (https://app.orizu.ai by default). To give someone an app's link, run \`orizu projects list\` to get the \`<team>/<project>\` slug, then \`orizu apps list --project <team>/<project>\`: it prints each app's full link. The --project flag is required here: prompts cannot run in this environment. Never guess a link.`

package/src/preview-runtime.ts

@@ -193,7 +193,6 @@ export async function runLocalAppPreview(options: AppPreviewOptions): Promise<Ap
   const htmlPath = join(tempDir, 'index.html')
   const outDir = join(tempDir, 'dist')
 
-  writeFileSync(cssPath, await buildPreviewCss(repoRoot, appPath), 'utf8')
   writeFileSync(entryPath, buildEntrySource(appPath, options.sampleRow), 'utf8')
   writeFileSync(htmlPath, buildPreviewHtml(), 'utf8')
 
@@ -219,6 +218,8 @@ export async function runLocalAppPreview(options: AppPreviewOptions): Promise<Ap
       )
     }
 
+    // After the dependency checks, so their actionable errors come before a Tailwind warning.
+    writeFileSync(cssPath, await buildPreviewCss(repoRoot, appPath), 'utf8')
     await esbuild.build({
       entryPoints: [entryPath],
       bundle: true,
@@ -656,12 +657,18 @@ function buildPreviewHtml() {
 `
 }
 
-export async function buildPreviewCss(repoRoot: string | null, appPath: string) {
+const PREVIEW_TAILWIND_FALLBACK_WARNING = 'Tailwind CSS could not be built; the preview uses fallback styles'
+
+async function loadPreviewCssModules() {
+  return { postcss: (await import('postcss')).default, tailwind: (await import('@tailwindcss/postcss')).default }
+}
+
+/** `loadModules` is for tests: one that fails stands in for a broken install. */
+export async function buildPreviewCss(repoRoot: string | null, appPath: string, loadModules: typeof loadPreviewCssModules = loadPreviewCssModules) {
   const fallbackCss = buildPreviewChromeCss()
 
   try {
-    const postcss = (await import('postcss')).default
-    const tailwind = (await import('@tailwindcss/postcss')).default
+    const { postcss, tailwind } = await loadModules()
     const cliPackageRoot = findCliPackageRoot()
     const globalsPath = repoRoot
       ? join(repoRoot, 'app', 'globals.css')
@@ -682,7 +689,10 @@ export async function buildPreviewCss(repoRoot: string | null, appPath: string)
     ].join('\n')
     const result = await postcss([tailwind()]).process(sourceCss, { from: globalsPath })
     return result.css
-  } catch {
+  } catch (error) {
+    // Without Tailwind the screenshot loses the app's utility styling, so say so
+    // instead of looking right (ORI-2261: the sandbox tools check fails on it).
+    process.stderr.write(`warning: ${PREVIEW_TAILWIND_FALLBACK_WARNING} (${error instanceof Error ? error.message : String(error)})\n`)
     return fallbackCss
   }
 }

package/vendor/skills/orizu/references/building-apps.md

@@ -1580,7 +1580,16 @@ orizu apps preview \
 
 The command validates the same app contract and allowed import registry as upload, validates the sample row against `input.json`, serves a temporary static preview page, passes `inputData`, `initialValues`, and `onComplete`, then uses Playwright to render it. Add `--headed` for visible Chromium review, and `--keep-open` when you want to inspect the local page manually. In the Orizu web checkout, preview uses the live component tree and global Tailwind CSS; in the mirrored/published CLI package, it uses the bundled preview runtime snapshot so the workflow remains available without the site source tree.
 
-The published CLI itself does not install the preview tooling (`esbuild`, `react`, `react-dom`, `@playwright/test`, Tailwind): run preview inside a project that provides them or from an Orizu checkout. When they are missing the command exits with an actionable error; the plain-`node` smoke test (`scripts/test-app.mjs`) still works everywhere in the meantime.
+In a hosted session, the sandbox already has the preview tooling and a headless Chromium. Run `orizu apps preview` with `--screenshot` as shown above; `--headed` and `--keep-open` are for local use and do not work in a sandbox. Do not `npm install` anything for it, including `react` or `react-dom`. If preview still fails there, run the plain-`node` smoke test (`scripts/test-app.mjs`) to check the app contract, then file the preview failure:
+
+```bash
+orizu feedback --category bug --severity major \
+  --summary "orizu apps preview fails in the hosted sandbox" \
+  --tried "<the orizu apps preview command you ran>" \
+  --actual "<the error it printed, without customer content>"
+```
+
+Locally, the published CLI does not install the preview tooling (`esbuild`, `react`, `react-dom`, `@playwright/test`, Tailwind): run preview inside a project that provides them or from an Orizu checkout. When they are missing the command exits with an actionable error; the plain-`node` smoke test (`scripts/test-app.mjs`) still works everywhere in the meantime.
 
 For coding agents: do not treat a passing contract check as enough. After generating or editing an app, run `orizu apps preview` with a representative row, inspect the screenshot, and compare the rendered workflow to the user's likely intent: are the right fields visible, is the primary judgment obvious, do controls fit, and would a human reviewer know what to do? If the screenshot looks wrong, revise the app and preview again before publishing.
 

package/vendor/skills/orizu/references/cli-reference.md

@@ -272,6 +272,8 @@ orizu apps archive <app-id> --project my-team/quality-eval
 orizu apps restore <app-id> --project my-team/quality-eval
 ```
 
+An app's page link is `<server>/preview/<app-id>` (`https://app.orizu.ai` by default). `apps list` prints a `Link: <app> <link>` line under the table for each app that is not archived; `apps list --json` has `pageUrl` for each app. `apps create` and `apps update` print it after `View app:`; `apps create --json` and `apps update --json` both have it as `app.pageUrl`. Get `<team>/<project>` from `orizu projects list`. Give that link; never guess one.
+
 Create from file:
 
 ```bash