toolroll 0.5.0

package/dist/browser-crew.d.ts

@@ -0,0 +1,11 @@
+/** Pure rendering projection shared by browser updates and server snapshots. */
+import type { BrowserCrewItem } from './browser-workspace.js';
+import type { WorkIndexItem, WorkIndexPage } from './work-index.js';
+/** The index is navigation only. Controls retain their exact owning task, run,
+ * decision and approval ceremony; opening a result keeps its saved execution. */
+export declare function browserWorkActionHref(item: WorkIndexItem): string | null;
+/** Render an already-admitted page without repeating its database query. */
+export declare function browserCrewFromIndex(page: WorkIndexPage, conversationId?: string): {
+    crew: BrowserCrewItem[];
+    crewTruncated: boolean;
+};

package/dist/browser-crew.js

@@ -0,0 +1,50 @@
+import { chatControlHref, chatResultHref } from './chat-controls.js';
+/** The index is navigation only. Controls retain their exact owning task, run,
+ * decision and approval ceremony; opening a result keeps its saved execution. */
+export function browserWorkActionHref(item) {
+    const action = item.primaryAction;
+    if (action === null)
+        return null;
+    const { taskId, runId, decisionId } = action.target;
+    if (decisionId !== null)
+        return `/d/${decisionId}`;
+    if (action.code === 'inspect-decisions')
+        return '/';
+    if (action.code === 'open-result' && runId !== null)
+        return chatResultHref(taskId, runId);
+    if (action.code === 'open-pr' && /^https:\/\/github\.com\/[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+\/pull\/\d+$/.test(item.publicationUrl ?? ''))
+        return item.publicationUrl;
+    if (runId !== null && (action.code === 'open-pr' || action.code === 'retry-review')) {
+        return `/review?result=${encodeURIComponent(taskId)}&run=${runId}${item.repo === null ? '' : '&project=' + encodeURIComponent(item.repo)}`;
+    }
+    if (runId !== null && (action.code === 'inspect-run' || action.code === 'reconcile-run'))
+        return `/r/${runId}`;
+    const anchor = action.code === 'approve-scope' ? '#approve'
+        : action.code === 'inspect-stop' || action.code === 'resume-run' ? '#task-control'
+            : action.code === 'unhold' || action.code === 'retry-task' ? '#task-actions'
+                : action.code === 'write-scope' || action.code === 'select-agent' ? '#scope'
+                    : action.code === 'inspect-hold' ? '#holds'
+                        : action.code === 'start-worker' || action.code === 'repair-dependency' ? '#run-status' : '';
+    return `/t/${encodeURIComponent(item.rootId)}?version=${encodeURIComponent(taskId)}` + anchor;
+}
+/** Render an already-admitted page without repeating its database query. */
+export function browserCrewFromIndex(page, conversationId) {
+    const link = (href) => conversationId && href.startsWith('/chat?') ? href + '&conversation=' + encodeURIComponent(conversationId) : href;
+    const rows = page.items.map(summary => {
+        const status = summary.status;
+        const resultHref = summary.resultRunId === null || summary.resultTaskId === null || (summary.resultOutcome !== 'built' && summary.resultOutcome !== 'no-change')
+            ? null : chatResultHref(summary.resultTaskId, summary.resultRunId);
+        const href = chatControlHref('task', summary.rootId);
+        const action = summary.primaryAction;
+        const actionHref = browserWorkActionHref(summary);
+        const item = {
+            id: summary.rootId, title: summary.title, project: summary.repo,
+            state: summary.assignmentState, label: status.label, tone: status.tone, href: link(href), resultHref: resultHref === null ? null : link(resultHref),
+            action: action === null || actionHref === null ? null : { label: action.label, href: link(actionHref) },
+        };
+        return { item, rank: status.rank };
+    });
+    // Stable ordering retains recency within each shared presentation rank.
+    rows.sort((a, b) => a.rank - b.rank);
+    return { crew: rows.map(row => row.item), crewTruncated: page.nextCursor !== null };
+}

package/dist/browser-shell.d.ts

@@ -0,0 +1,8 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import { type BrowserWorkspace } from './browser-workspace.js';
+export declare function browserAssetsAvailable(): boolean;
+export declare function serveBrowserAsset(request: IncomingMessage, response: ServerResponse, path: string): boolean;
+/** Retain the complete native document as the no-JavaScript/unloaded-bundle
+ * fallback. React replaces its root only once the local module has loaded.
+ * The data script is escaped for HTML parsing, not merely valid JSON. */
+export declare function browserWorkspaceDocument(html: string, workspace: BrowserWorkspace, nonce: string, functionalScript: string): string;

package/dist/browser-shell.js

@@ -0,0 +1,60 @@
+/** The browser bundle is a presentation client. Only these fixed public assets
+ * are readable here; authenticated data stays in the existing page handlers. */
+import { readFileSync } from 'node:fs';
+import { serializeBrowserWorkspace } from './browser-workspace.js';
+const assets = new Map();
+function readAsset(name) {
+    // Compiled installation first; the second location supports source-based
+    // development/tests after the browser build. No request supplies a file path.
+    for (const location of [new URL(`./browser/${name}`, import.meta.url), new URL(`../dist/browser/${name}`, import.meta.url)]) {
+        try {
+            return readFileSync(location);
+        }
+        catch { /* An unbuilt checkout retains the HTML surface. */ }
+    }
+    return null;
+}
+export function browserAssetsAvailable() {
+    if (assets.size === 3)
+        return true;
+    for (const [name, type] of [['workspace.js', 'text/javascript; charset=utf-8'], ['workspace.css', 'text/css; charset=utf-8'], ['THIRD_PARTY_NOTICES.txt', 'text/plain; charset=utf-8']]) {
+        const body = readAsset(name);
+        if (body === null)
+            return false;
+        assets.set(`/assets/${name}`, { body, type });
+    }
+    return true;
+}
+export function serveBrowserAsset(request, response, path) {
+    if (path !== '/assets/workspace.js' && path !== '/assets/workspace.css' && path !== '/assets/THIRD_PARTY_NOTICES.txt')
+        return false;
+    if (request.method !== 'GET' && request.method !== 'HEAD') {
+        response.writeHead(405, { allow: 'GET, HEAD', 'cache-control': 'no-store' });
+        response.end();
+        return true;
+    }
+    browserAssetsAvailable();
+    const asset = assets.get(path);
+    response.writeHead(asset ? 200 : 404, {
+        'content-type': asset?.type ?? 'text/plain; charset=utf-8',
+        'cache-control': 'no-store', 'x-content-type-options': 'nosniff',
+        'content-security-policy': "default-src 'none'",
+        ...(asset ? { 'content-length': asset.body.length } : {}),
+    });
+    response.end(request.method === 'HEAD' ? undefined : asset?.body ?? 'Browser assets are not built.');
+    return true;
+}
+/** Retain the complete native document as the no-JavaScript/unloaded-bundle
+ * fallback. React replaces its root only once the local module has loaded.
+ * The data script is escaped for HTML parsing, not merely valid JSON. */
+export function browserWorkspaceDocument(html, workspace, nonce, functionalScript) {
+    const initialize = `window.addEventListener('standing-orders:workspace-rendered',function initializeWorkspace(){window.removeEventListener('standing-orders:workspace-rendered',initializeWorkspace);${functionalScript}});`;
+    // A cross-page fade the browser gives up on rejects its promises; settle them from the head, before the
+    // first frame (the app's own listener arrives too late when a page is revealed before the bundle runs).
+    const settleFades = `(function(){function s(e){var f=e.viewTransition;if(f)[f.finished,f.ready,f.updateCallbackDone].forEach(function(p){if(p)p.catch(function(){})})}addEventListener('pageswap',s);addEventListener('pagereveal',s)})();`;
+    return html
+        // A page showing a password keeps to its one script (the sensitivity contract), so it goes without.
+        .replace('</head>', `<link rel="stylesheet" href="/assets/workspace.css">${workspace.sensitive ? "" : `<script nonce="${nonce}">${settleFades}</script>`}</head>`)
+        .replace('<body>', '<body><div id="standing-orders-workspace">')
+        .replace('</body>', `</div><script type="application/json" id="standing-orders-workspace-data" nonce="${nonce}">${serializeBrowserWorkspace(workspace)}</script><script nonce="${nonce}">${initialize}</script><script type="module" src="/assets/workspace.js" nonce="${nonce}"></script></body>`);
+}