humanish 0.50.0 → 0.51.0

package/dist/lab-summary.d.ts

@@ -0,0 +1,36 @@
+export declare const LAB_SUMMARY_SCHEMA = "humanish.lab-summary.v1";
+export interface LabCaps {
+    /** Per-lane blast-radius budget. */
+    laneUsd?: number;
+    /** Shared study budget across every lane. */
+    studyUsd?: number;
+}
+export interface LabSummary {
+    schema: typeof LAB_SUMMARY_SCHEMA;
+    labId: string;
+    title?: string;
+    description?: string;
+    /** "clone drawdb-io/drawdb", "app-url http://127.0.0.1:3000/", "this-repo". */
+    subject?: string;
+    /** How many participants and who they are: `1 × synthetic-new-user`. */
+    participants?: string;
+    /** The model that will actually run, override or default. */
+    model?: string;
+    caps: LabCaps;
+    /**
+     * Whether every key a LIVE run of this lab needs is resolvable right now. `undefined` when not
+     * checked. Names only — a value never leaves the key layer.
+     */
+    keysReady?: boolean;
+    missingKeys?: string[];
+}
+export interface ReadLabSummaryOptions {
+    /** Skip the key probe (it touches vendor stores); the screen then shows no keys line. */
+    checkKeys?: boolean;
+    env?: NodeJS.ProcessEnv;
+}
+/**
+ * Describe one lab. Returns null when the manifest cannot be resolved — the caller already knows
+ * the lab exists from the listing, so this failing means the file changed underneath them.
+ */
+export declare function readLabSummary(cwd: string, lab: string, options?: ReadLabSummaryOptions): Promise<LabSummary | null>;

package/dist/lab-summary.js

@@ -0,0 +1,86 @@
+// What a lab IS, for the surface that has to describe it before you spend money (#455).
+//
+// The run index and run detail answer questions about runs. This answers a question about the LAB
+// itself — what it drives, who is in it, which model, and what it is allowed to spend — which is
+// what a stakeholder reads on the screen where they decide whether to press Start.
+//
+// Every field is optional and omitted when the manifest does not declare it. A cap that is not
+// declared is not "unlimited" and not "$0"; it is a line the screen does not draw.
+import { DEFAULT_OPENAI_CU_MODEL } from "./openai-responses-cu.js";
+import { inspectLabManifest } from "./labs.js";
+import { probeKeySources } from "./key-resolution.js";
+export const LAB_SUMMARY_SCHEMA = "humanish.lab-summary.v1";
+/** One short phrase for what the lab drives. */
+function subjectOf(config) {
+    const subject = config.subject;
+    if (subject?.source === undefined)
+        return undefined;
+    const repo = subject.repos?.[0];
+    if (repo !== undefined)
+        return `${subject.source} ${repo}`;
+    if (subject.appUrl !== undefined)
+        return `${subject.source} ${subject.appUrl}`;
+    return subject.source;
+}
+/** How many participants, and who — collapsed when they are all the same persona. */
+function participantsOf(config) {
+    const actors = config.actors;
+    const actor = actors?.[0];
+    if (actor === undefined)
+        return undefined;
+    const lanePersonas = (actor.lanes ?? []).map((lane) => lane.persona).filter((persona) => typeof persona === "string");
+    const personas = lanePersonas.length > 0 ? lanePersonas : actor.persona === undefined ? [] : [actor.persona];
+    const count = actor.count ?? actor.lanes?.length ?? personas.length ?? 1;
+    const unique = [...new Set(personas)];
+    if (unique.length === 0)
+        return `${count} participant${count === 1 ? "" : "s"}`;
+    // Several lanes of ONE persona reads as "3 × skeptical-power-user"; genuinely different people
+    // are named, because which personas are in a study is the study's design.
+    return unique.length === 1 ? `${count} × ${unique[0]}` : unique.join(" · ");
+}
+function capsOf(config) {
+    const caps = config.policies?.caps
+        ?? config.caps;
+    return {
+        ...(typeof caps?.maxUsd === "number" ? { laneUsd: caps.maxUsd } : {}),
+        ...(typeof caps?.maxTotalUsd === "number" ? { studyUsd: caps.maxTotalUsd } : {})
+    };
+}
+/**
+ * Describe one lab. Returns null when the manifest cannot be resolved — the caller already knows
+ * the lab exists from the listing, so this failing means the file changed underneath them.
+ */
+export async function readLabSummary(cwd, lab, options = {}) {
+    const inspected = await inspectLabManifest(cwd, lab).catch(() => null);
+    if (inspected === null || !inspected.ok || inspected.config === undefined)
+        return null;
+    const config = inspected.config;
+    const actors = config.actors;
+    let keysReady;
+    let missingKeys;
+    if (options.checkKeys === true) {
+        // Only the keys a live run of THIS lab would need. Names only; no value is read or returned.
+        const needed = ["OPENAI_API_KEY", "E2B_API_KEY"];
+        const probes = await probeKeySources(needed, { cwd, env: options.env ?? process.env }).catch(() => []);
+        const missing = probes.filter((probe) => probe.source === null).map((probe) => probe.name);
+        keysReady = probes.length > 0 && missing.length === 0;
+        if (missing.length > 0)
+            missingKeys = missing;
+    }
+    // Computed once: a test-then-use pair reads as though the two calls could differ.
+    const subject = subjectOf(config);
+    const participants = participantsOf(config);
+    return {
+        schema: LAB_SUMMARY_SCHEMA,
+        labId: String(config.id ?? lab),
+        ...(typeof config.title === "string" ? { title: config.title } : {}),
+        ...(typeof config.description === "string" ? { description: config.description.trim() } : {}),
+        ...(subject === undefined ? {} : { subject }),
+        ...(participants === undefined ? {} : { participants }),
+        model: actors?.[0]?.model ?? DEFAULT_OPENAI_CU_MODEL,
+        caps: capsOf(config),
+        ...(keysReady === undefined ? {} : { keysReady }),
+        ...(missingKeys === undefined ? {} : { missingKeys })
+    };
+}
+//# sourceMappingURL=lab-summary.js.map

package/dist/lab-summary.js.map

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

package/dist/program.js

@@ -25,6 +25,8 @@ import { cleanupOssMetaLabSandboxes, cleanupStaleOssMetaLabSandboxes, runOssMeta
 import { cleanupRun, doctor, listRuns, readReview, runDryRun, verifyRun } from "./run.js";
 import { reclaimRunSandboxes } from "./reclaim.js";
 import { RunIndexCache, readRunIndex } from "./run-index.js";
+import { readLabSummary } from "./lab-summary.js";
+import { readProjectState } from "./tui-project.js";
 import { readRunDetail } from "./run-detail.js";
 import { launchRun, readLaunchLogTail } from "./tui-launch.js";
 import { TUI_MIN_NODE_MAJOR, nodeSupportsTui, tuiBundleUrl } from "./tui-contract.js";
@@ -331,7 +333,9 @@ function registerTuiCommand(parent, io) {
                 listLabs: listLabManifests,
                 startRun: launchRun,
                 readLaunchLog: readLaunchLogTail,
-                readRunDetail
+                readRunDetail,
+                readLabSummary,
+                readProjectState
             },
             stdin,
             stdout