@quickchatai/pi-quickreview 0.0.0-stage → 1.2.0

package/dist/src/engine/lens/registry.d.ts

@@ -0,0 +1,55 @@
+/** One source directory of agent `.md` files. */
+export interface AgentLayer {
+    dir: string;
+    /** `"built"`: `buildAgents` output (the seeds composed with addenda).
+     * `"profile"`: an operator's or repo's profile agents, which replace a
+     * built agent of the same name. */
+    origin: "built" | "profile";
+}
+export interface LensAgent {
+    /** The frontmatter `name:` — `<pass>--<tier>` for a built agent. */
+    name: string;
+    description: string;
+    /** The frontmatter `model:` WHOLE, `provider/model[:thinking]` — what the
+     * example hands pi's `--model`. Undefined when the file names none. */
+    model: string | undefined;
+    /** `model` without its `:thinking` suffix. */
+    modelId: string | undefined;
+    /** The spec's `:thinking` suffix, else the `thinking:` field, else null. */
+    thinking: string | null;
+    /** The `tools:` allowlist; undefined when the file has none (no allowlist,
+     * which is not the same statement as an empty one). */
+    tools: string[] | undefined;
+    /** The system prompt: everything after the frontmatter, trimmed. */
+    body: string;
+    filePath: string;
+    origin: AgentLayer["origin"];
+    /** The file of the same-named agent from an earlier layer that this one
+     * replaced (a profile over a built agent). Null when it replaced nothing. */
+    overrides: string | null;
+}
+export interface SkippedAgent {
+    filePath: string;
+    reason: string;
+}
+export interface AgentRegistry {
+    readonly agents: ReadonlyMap<string, LensAgent>;
+    /** Files the registry did not load, and why. */
+    readonly skipped: readonly SkippedAgent[];
+    get(name: string): LensAgent | undefined;
+    names(): string[];
+    /** Agents whose body came from a profile layer, in name order. */
+    customised(): LensAgent[];
+}
+/** Parse one agent file; a string is the reason it is not an agent. */
+export declare function parseAgentFile(text: string, filePath: string, origin: AgentLayer["origin"]): LensAgent | string;
+/**
+ * Load the registry from `layers`, earlier first. A missing or unreadable
+ * dir is an empty layer. Within one layer a second file naming an agent
+ * already loaded from it loses (filename order) and is reported; across
+ * layers the later one replaces the earlier and records what it replaced.
+ */
+export declare function loadAgentRegistry(layers: readonly AgentLayer[]): AgentRegistry;
+/** The registry of one `buildAgents` output dir. */
+export declare function loadBuiltAgents(dir: string): AgentRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/src/engine/lens/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/engine/lens/registry.ts"],"names":[],"mappings":"AAuBA,iDAAiD;AACjD,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ;;uCAEmC;IACnC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACxB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB;2EACuE;IACvE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,8CAA8C;IAC9C,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;2DACuD;IACvD,KAAK,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC5B,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC7B;iFAC6E;IAC7E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAChD,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IAC1C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IACzC,KAAK,IAAI,MAAM,EAAE,CAAC;IAClB,kEAAkE;IAClE,UAAU,IAAI,SAAS,EAAE,CAAC;CAC3B;AA8BD,uEAAuE;AACvE,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,GAC3B,SAAS,GAAG,MAAM,CAuBpB;AAaD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,aAAa,CAsC9E;AAED,oDAAoD;AACpD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAE1D"}

package/dist/src/engine/lens/registry.js

@@ -0,0 +1,140 @@
+// The lens agent registry: which lens definitions a session may name, read
+// from the `<pass>--<tier>.md` files `buildAgents` (packages/pi-plugin/src/include.ts) writes.
+// It stands where pi's example subagent extension (examples/extensions/
+// subagent/agents.ts) and QCR_SUBAGENT_SCOPE stand on the tmux route: the
+// engine hands it the built agents dir (and, later, profile dirs) explicitly,
+// so no scope env, no `~/.pi/agent/agents` symlink and no repo `.pi/agents`
+// discovery decides what a lens can be.
+//
+// Parsing is `splitFrontmatter` plus the same field reading the example does
+// (name, description, tools, model; the body trimmed), so the registry names
+// exactly the agents the example would have found, with the same values. The
+// two are compared in tests/lens-registry.test.ts. A file the example would
+// skip (no name or no description) is skipped here too, and reported.
+//
+// Layers: the built dir first, profile dirs after. A later layer's agent of
+// the same name replaces the earlier one, and the registry says so — a lens
+// whose body came from a profile is "customised" (distribution ruling: a
+// profile that overrides a seed marks the output).
+import { readdirSync, readFileSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { splitModelSpec } from "../../reviewconfig.js";
+import { splitFrontmatter } from "../../include.js";
+/** A scalar frontmatter value: one line, surrounding quotes dropped. */
+function scalar(raw) {
+    const v = raw.trim();
+    const q = v[0];
+    if ((q === '"' || q === "'") && v.length >= 2 && v.endsWith(q))
+        return v.slice(1, -1);
+    return v;
+}
+function field(frontmatter, key) {
+    const m = new RegExp(`^${key}:[ \\t]*(.*)$`, "m").exec(frontmatter);
+    if (!m)
+        return undefined;
+    const v = scalar(m[1] ?? "");
+    return v === "" ? undefined : v;
+}
+/** `tools: read, bash` and `tools: [read, bash]` both name two tools; a line
+ * with nothing usable on it yields no allowlist, as in the example. */
+function toolList(frontmatter) {
+    const raw = field(frontmatter, "tools");
+    if (raw === undefined)
+        return undefined;
+    const inner = raw.startsWith("[") && raw.endsWith("]") ? raw.slice(1, -1) : raw;
+    const tools = inner
+        .split(",")
+        .map((t) => scalar(t))
+        .filter((t) => t.length > 0);
+    return tools.length > 0 ? tools : undefined;
+}
+/** Parse one agent file; a string is the reason it is not an agent. */
+export function parseAgentFile(text, filePath, origin) {
+    // pi's parser normalises newlines and drops a BOM before looking for the fence.
+    const normalised = text.replace(/^\uFEFF/, "").replace(/\r\n?/g, "\n");
+    const doc = splitFrontmatter(normalised);
+    if (!doc.hasFrontmatter)
+        return "no frontmatter block";
+    const name = field(doc.frontmatter, "name");
+    if (name === undefined)
+        return "no name in the frontmatter";
+    const description = field(doc.frontmatter, "description");
+    if (description === undefined)
+        return "no description in the frontmatter";
+    const model = field(doc.frontmatter, "model");
+    const split = model === undefined ? undefined : splitModelSpec(model);
+    return {
+        name,
+        description,
+        model,
+        modelId: split?.model,
+        thinking: split?.thinking ?? field(doc.frontmatter, "thinking") ?? null,
+        tools: toolList(doc.frontmatter),
+        body: doc.body.trim(),
+        filePath,
+        origin,
+        overrides: null,
+    };
+}
+function mdFiles(dir) {
+    try {
+        if (!statSync(dir).isDirectory())
+            return [];
+        return readdirSync(dir)
+            .filter((f) => f.endsWith(".md"))
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Load the registry from `layers`, earlier first. A missing or unreadable
+ * dir is an empty layer. Within one layer a second file naming an agent
+ * already loaded from it loses (filename order) and is reported; across
+ * layers the later one replaces the earlier and records what it replaced.
+ */
+export function loadAgentRegistry(layers) {
+    const agents = new Map();
+    const skipped = [];
+    for (const layer of layers) {
+        const fromThisLayer = new Set();
+        for (const file of mdFiles(layer.dir)) {
+            const filePath = join(layer.dir, file);
+            let text;
+            try {
+                text = readFileSync(filePath, "utf8");
+            }
+            catch (err) {
+                skipped.push({ filePath, reason: `unreadable: ${err.message}` });
+                continue;
+            }
+            const parsed = parseAgentFile(text, filePath, layer.origin);
+            if (typeof parsed === "string") {
+                skipped.push({ filePath, reason: parsed });
+                continue;
+            }
+            if (fromThisLayer.has(parsed.name)) {
+                skipped.push({ filePath, reason: `duplicate agent name ${parsed.name} in ${layer.dir}` });
+                continue;
+            }
+            fromThisLayer.add(parsed.name);
+            const earlier = agents.get(parsed.name);
+            agents.set(parsed.name, { ...parsed, overrides: earlier?.filePath ?? null });
+        }
+    }
+    return {
+        agents,
+        skipped,
+        get: (name) => agents.get(name),
+        names: () => [...agents.keys()].sort(),
+        customised: () => [...agents.values()]
+            .filter((a) => a.origin === "profile")
+            .sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0)),
+    };
+}
+/** The registry of one `buildAgents` output dir. */
+export function loadBuiltAgents(dir) {
+    return loadAgentRegistry([{ dir, origin: "built" }]);
+}
+//# sourceMappingURL=registry.js.map

package/dist/src/engine/lens/registry.js.map

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

package/dist/src/engine/lens/round-lens.d.ts

@@ -0,0 +1,16 @@
+import type { PiHost } from "../pisdk.js";
+import type { SessionSpec } from "../port.js";
+import { type EngineLensTools } from "./engine-tools.js";
+import type { LensRunConfig } from "./runlens.js";
+/** Where a round's built lens agents are: the nearest `.pi/agents` above the cwd
+ * for the `project` scope (the bench's), else the agent dir's `agents` (the host
+ * route's `user` scope). */
+export declare function lensAgentsDir(env: Readonly<Record<string, string | undefined>>, cwd: string): string;
+/** The lens runner's config for the round `spec` opens, over the agents its
+ * scope names. A pass's bash draws from the same names as the main session's
+ * (the git isolation pins, QCR_*): on proc a pass child inherits the whole env,
+ * and the pins must reach it all the same. */
+export declare function roundLensConfig(spec: SessionSpec, host: PiHost): LensRunConfig;
+/** `lens` and `lens_wave` for the round `spec` opens, running its passes on `host`. */
+export declare function roundLensTools(spec: SessionSpec, host: PiHost): EngineLensTools;
+//# sourceMappingURL=round-lens.d.ts.map

package/dist/src/engine/lens/round-lens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"round-lens.d.ts","sourceRoot":"","sources":["../../../../src/engine/lens/round-lens.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAE1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD;;4BAE4B;AAC5B,wBAAgB,aAAa,CAC3B,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,EACjD,GAAG,EAAE,MAAM,GACV,MAAM,CAUR;AAED;;;8CAG8C;AAC9C,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAM9E;AAED,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,CAE/E"}

package/dist/src/engine/lens/round-lens.js

@@ -0,0 +1,46 @@
+// The engine's lens tools for one round's main session, built from the session's
+// spec: the passes' agents, cwd, env, cap, deadline and cache groups are read
+// from the same env names the native tool reads (`QCR_SUBAGENT_*`), so one
+// config drives either tool. A route that hosts a round on the SDK with
+// `[pi] lens_runtime = "engine"` passes this as its `lens` (src/engine/
+// reviewsdk.ts); the passes run on the same PiHost as the main session.
+import { existsSync, statSync } from "node:fs";
+import { dirname, isAbsolute, join, resolve } from "node:path";
+import { lensRunConfigFromEnv } from "../../../extensions/lens.js";
+import { BASH_ENV_ALLOW } from "../roundsdk.js";
+import { SCOPE_ENV } from "./env.js";
+import { engineLensTools } from "./engine-tools.js";
+import { loadBuiltAgents } from "./registry.js";
+/** Where a round's built lens agents are: the nearest `.pi/agents` above the cwd
+ * for the `project` scope (the bench's), else the agent dir's `agents` (the host
+ * route's `user` scope). */
+export function lensAgentsDir(env, cwd) {
+    const agentDir = env["PI_CODING_AGENT_DIR"];
+    if (agentDir === undefined || !isAbsolute(agentDir))
+        throw new Error(`lens: PI_CODING_AGENT_DIR is not an absolute path (${String(agentDir)})`);
+    if ((env[SCOPE_ENV] ?? "").trim() !== "project")
+        return join(agentDir, "agents");
+    for (let dir = resolve(cwd);; dir = dirname(dir)) {
+        const candidate = join(dir, ".pi", "agents");
+        if (existsSync(candidate) && statSync(candidate).isDirectory())
+            return candidate;
+        if (dirname(dir) === dir)
+            throw new Error(`lens: no .pi/agents at or above ${cwd}`);
+    }
+}
+/** The lens runner's config for the round `spec` opens, over the agents its
+ * scope names. A pass's bash draws from the same names as the main session's
+ * (the git isolation pins, QCR_*): on proc a pass child inherits the whole env,
+ * and the pins must reach it all the same. */
+export function roundLensConfig(spec, host) {
+    const registry = loadBuiltAgents(lensAgentsDir(spec.env, spec.cwd));
+    return {
+        ...lensRunConfigFromEnv(spec.env, host, spec.cwd, registry),
+        bashEnv: { allow: BASH_ENV_ALLOW },
+    };
+}
+/** `lens` and `lens_wave` for the round `spec` opens, running its passes on `host`. */
+export function roundLensTools(spec, host) {
+    return engineLensTools(roundLensConfig(spec, host));
+}
+//# sourceMappingURL=round-lens.js.map

package/dist/src/engine/lens/round-lens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"round-lens.js","sourceRoot":"","sources":["../../../../src/engine/lens/round-lens.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,8EAA8E;AAC9E,2EAA2E;AAC3E,wEAAwE;AACxE,wEAAwE;AACxE,wEAAwE;AACxE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,eAAe,EAAwB,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGhD;;4BAE4B;AAC5B,MAAM,UAAU,aAAa,CAC3B,GAAiD,EACjD,GAAW;IAEX,MAAM,QAAQ,GAAG,GAAG,CAAC,qBAAqB,CAAC,CAAC;IAC5C,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,sDAAsD,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC7F,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACjF,KAAK,IAAI,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,GAAI,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC7C,IAAI,UAAU,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;YAAE,OAAO,SAAS,CAAC;QACjF,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,GAAG,EAAE,CAAC,CAAC;IACtF,CAAC;AACH,CAAC;AAED;;;8CAG8C;AAC9C,MAAM,UAAU,eAAe,CAAC,IAAiB,EAAE,IAAY;IAC7D,MAAM,QAAQ,GAAG,eAAe,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACpE,OAAO;QACL,GAAG,oBAAoB,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC;QAC3D,OAAO,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE;KACnC,CAAC;AACJ,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,cAAc,CAAC,IAAiB,EAAE,IAAY;IAC5D,OAAO,eAAe,CAAC,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AACtD,CAAC"}

package/dist/src/engine/lens/runlens.d.ts

@@ -0,0 +1,103 @@
+import type { ExtensionError, ExtensionFactory } from "@earendil-works/pi-coding-agent";
+import { type LensResult } from "../../lensresult.js";
+import type { LiveSink } from "../../live/writer.js";
+import type { BashEnvOptions, PiHost } from "../pisdk.js";
+import type { AgentsFile } from "../port.js";
+import type { AgentRegistry } from "./registry.js";
+import { type Permits } from "./permits.js";
+import { WeightedSemaphore } from "./semaphore.js";
+/** Where a round's lifecycle events go: the `pr-<n>.jsonl` transition log the
+ * round-progress extension writes on the tmux route, here written by the engine
+ * through the same writer and line shape. */
+export interface LensProgressSink {
+    /** The transition log, `state/round-progress/pr-<n>.jsonl`. */
+    logPath: string;
+    pr: number;
+    session: string;
+    /** ISO time the run (the round's main session) started. */
+    runStartedAt: string;
+    commandId?: string;
+}
+/** Lens cache groups. */
+export interface LensCacheConfig {
+    /** Passes per group, per model; below 1 there are no groups. */
+    size: number;
+    /** How long a pack-less group's later passes start after its first. */
+    staggerMs: number;
+    /** The round's context pack text. Present: each group is warmed with it and
+     * every request is rewritten pack-first. Absent: the stagger applies. */
+    pack?: string;
+    /** How long a pass waits for its group's warm-up. Default 30 s. */
+    warmupWaitMs?: number;
+}
+/** Gap between session creations on one host. Creating a wave at once blocks
+ * the loop for seconds (0.7 to 2.5 s for 8 to 20 sessions). */
+export declare const DEFAULT_SESSION_GAP_MS = 25;
+export interface LensRunConfig {
+    host: PiHost;
+    /** The cap on passes in flight for this host. The first runner on a host sets
+     * it; a later runner on the same host must ask for the same number. Unused when
+     * `permitPort` is given. */
+    permits: number;
+    /** Where a pass gets its permit. Omitted: the host's local semaphore, sized by
+     * `permits`. A bot worker passes the daemon's broker client. */
+    permitPort?: Permits;
+    registry: AgentRegistry;
+    /** The passes' working directory (also their bash tool's). */
+    cwd: string;
+    /** The environment the model's bash may draw from. */
+    env: Readonly<Record<string, string | undefined>>;
+    /** The bash-guard factory, attached to every pass. Required: there is no
+     * lens without it. */
+    bashGuard: ExtensionFactory;
+    /** Append-only `lens-ledger.jsonl`; one line per pass. */
+    ledgerPath: string;
+    /** context files. Omitted: the host's. */
+    agentsFiles?: readonly AgentsFile[];
+    bashEnv?: BashEnvOptions;
+    /** `provider/id` for an agent file that names no model. */
+    defaultModel?: string;
+    /** Per-attempt deadline. Omitted: none. */
+    deadlineMs?: number;
+    /** Cache groups. Omitted: every pass has a session id of its own. */
+    cache?: LensCacheConfig;
+    /** Minimum gap between two session creations on this host. 0 turns the
+     * stagger off. Default DEFAULT_SESSION_GAP_MS. */
+    sessionGapMs?: number;
+    progress?: LensProgressSink;
+    /** Keep each pass's session JSONL under `<sessionsDir>/<run id>/`, so a
+     * finished lens opens in pi (`qcr open --lens`). A retried pass writes a second
+     * file beside the first. Omitted: the passes stay in memory. */
+    sessionsDir?: string;
+    /** The lens session's LiveEvent log (`lens-<id>.jsonl`): given the run's id
+     * and agent, returns the sink the session's events are fed to. Closed when
+     * the attempt ends. A sink that cannot be made is a warning, never a failure. */
+    live?: (id: string, agent: string) => LiveSink;
+    /** Hears every extension error pi reports instead of throwing. */
+    onExtensionError?: (agent: string, id: string, error: ExtensionError) => void;
+    /** A ledger or progress write that failed (diagnostic only; never fatal).
+     * The host's sink: omitted, nowhere. */
+    warn?: (message: string) => void;
+    now?: () => number;
+    newId?: () => string;
+}
+export interface LensRequest {
+    agent: string;
+    task: string;
+    /** Ends the pass: the session is aborted and the result says so. */
+    signal?: AbortSignal;
+}
+export interface LensRun {
+    result: LensResult;
+    /** The pass's last assistant text; "" when it produced none. */
+    text: string;
+}
+export interface LensRunner {
+    run(request: LensRequest): Promise<LensRun>;
+    /** Passes with a live session right now. */
+    liveSessions(): number;
+}
+/** The host's one lens cap, created on first use. */
+export declare function lensSemaphoreFor(host: PiHost, permits: number): WeightedSemaphore;
+export declare function createLensRunner(config: LensRunConfig): LensRunner;
+//# sourceMappingURL=runlens.d.ts.map

package/dist/src/engine/lens/runlens.d.ts.map

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