@inhuman.tools/harness-sdk 0.0.0-stage → 0.2.0

package/LICENSE.md

@@ -0,0 +1,7 @@
+Copyright 2026 Merkle Bonsai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/dist/client-agents-tree.d.ts

@@ -0,0 +1,123 @@
+import { type SessionUnfinished } from "@inhuman.tools/harness-model/session";
+import { type AgentTempo } from "./client-agents.js";
+import type { Client } from "./client.js";
+/** Ceiling for this-project conversations in the drawer. Not a visible-row target. */
+export declare const DRAWER_RECENT_SESSION_LIMIT = 20;
+/** U+25B8. Text play — resident background work. Not emoji. */
+export declare const SESSION_FACE_PLAY = "\u25B8";
+/** U+2016. Text pause — parked leftover work. Not emoji. */
+export declare const SESSION_FACE_PAUSE = "\u2016";
+/** Occupied ask. Paint is `attention` — same hue as the always-approve chip. */
+export declare const SESSION_FACE_ASK = "awaiting approval";
+/** Speech-question pin. Not license cover. */
+export declare const SESSION_FACE_QUESTION = "has a question";
+export type AgentDrawerCall = {
+    readonly key: string;
+    readonly spec: string;
+    readonly tempo: AgentTempo;
+    readonly status: string;
+    readonly prompt: string;
+    readonly notifies: readonly string[];
+    readonly result: string;
+    readonly sessionId: string;
+    readonly oneShot: boolean;
+    readonly completed: boolean;
+    readonly model: string;
+    readonly lastPrompt: string;
+    readonly askLine: string;
+    readonly unfinished: SessionUnfinished;
+    readonly mark: string;
+    readonly children: readonly AgentDrawerCall[];
+};
+export type AgentDrawerProgram = {
+    readonly key: string;
+    readonly name: string;
+    readonly children: readonly AgentDrawerCall[];
+};
+export type AgentDrawerCallNode = {
+    readonly kind: "program";
+    readonly program: AgentDrawerProgram;
+} | {
+    readonly kind: "call";
+    readonly call: AgentDrawerCall;
+};
+export type AgentDrawerCollaborator = {
+    readonly key: string;
+    readonly sessionId: string;
+    readonly spec: string;
+    readonly tempo: AgentTempo;
+    readonly status: string;
+    readonly keepAlive: boolean;
+    readonly prompt: string;
+    readonly notifies: readonly string[];
+    readonly result: string;
+};
+export type AgentDrawerSession = {
+    readonly key: string;
+    readonly sessionId: string;
+    readonly title: string;
+    readonly status: string;
+    readonly model: string;
+    readonly lastMessageAt: number;
+    readonly occupied: boolean;
+    readonly resident: boolean;
+    readonly periodArmed: boolean;
+    readonly openTurn: boolean;
+    readonly openToolCount: number;
+    readonly unfinished: SessionUnfinished;
+    readonly tempo: AgentTempo;
+    readonly mark: string;
+    readonly lastPrompt: string;
+    readonly askLine: string;
+    readonly current: boolean;
+};
+export type AgentDrawerRowKind = "call" | "bot" | "session";
+export type AgentDrawerRow = {
+    readonly key: string;
+    readonly kind: AgentDrawerRowKind;
+    readonly spec: string;
+    readonly recap: string;
+    readonly indent: number;
+    readonly prompt: string;
+    readonly notifies: readonly string[];
+    readonly result: string;
+    readonly tempo: AgentTempo;
+    readonly model: string;
+    readonly mark: string;
+    readonly lastPrompt: string;
+    readonly askLine: string;
+    readonly unfinished: SessionUnfinished;
+    readonly current: boolean;
+    /** Worker or conversation id. Empty until a Call intern stamps `workerSessionId`. */
+    readonly sessionId: string;
+};
+export type AgentDrawerProjection = {
+    readonly calls: readonly AgentDrawerCallNode[];
+    readonly collaborators: readonly AgentDrawerCollaborator[];
+    readonly sessions: readonly AgentDrawerSession[];
+};
+export type AgentMeterGroup = {
+    readonly spec: string;
+    readonly count: number;
+};
+export type AgentMeterProjection = {
+    readonly calls: readonly AgentMeterGroup[];
+    readonly bots: readonly string[];
+};
+export declare function projectAgentDrawer(client: Client): AgentDrawerProjection;
+/** Call row for a tape mention. Settled calls stay off `flattenAgentDrawer` and still resolve. */
+export declare function mentionedAgentCall(client: Client, key: string): {
+    readonly key: string;
+    readonly sessionId: string;
+} | null;
+export declare function flattenAgentDrawer(proj: AgentDrawerProjection): readonly AgentDrawerRow[];
+export declare function projectRecentSessions(client: Client): readonly AgentDrawerSession[];
+export declare function sessionOverviewMark(input: {
+    readonly current: boolean;
+    readonly occupied: boolean;
+    readonly resident: boolean;
+    readonly unfinished: SessionUnfinished;
+    readonly periodArmed: boolean;
+}): string;
+export declare function projectAgentMeter(client: Client, proj?: AgentDrawerProjection): AgentMeterProjection | null;
+//# sourceMappingURL=client-agents-tree.d.ts.map

package/dist/client-agents-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-agents-tree.d.ts","sourceRoot":"","sources":["../src/client-agents-tree.ts"],"names":[],"mappings":"AAiBA,OAAO,EAOL,KAAK,iBAAiB,EAGvB,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,sFAAsF;AACtF,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAE9C,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB,WAAM,CAAC;AACrC,4DAA4D;AAC5D,eAAO,MAAM,kBAAkB,WAAM,CAAC;AACtC,gFAAgF;AAChF,eAAO,MAAM,gBAAgB,sBAAsB,CAAC;AACpD,8CAA8C;AAC9C,eAAO,MAAM,qBAAqB,mBAAmB,CAAC;AAEtD,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAA;CAAE,GAClE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC;AAE9D,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;AAE5D,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,qFAAqF;IACrF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,QAAQ,CAAC,aAAa,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC3D,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC,CAAC;AA0BF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB,CAoCxE;AAED,kGAAkG;AAClG,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkB7D;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,qBAAqB,GAAG,SAAS,cAAc,EAAE,CAwDzF;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,kBAAkB,EAAE,CAoDnF;AAsCD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B,GAAG,MAAM,CAqBT;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,qBAAkD,GACvD,oBAAoB,GAAG,IAAI,CA0B7B"}

package/dist/client-agents-tree.js

@@ -0,0 +1,504 @@
+/**
+ * Drawer projection over the existing gatherer. Tape order is the tree.
+ * Does not intern workers. Does not wait on Agent.parent.
+ *
+ * Compact meter: left is the live huddle — unfinished calls whose worker
+ * is not a pal. Right is pals this tape already talked to: keepAlive
+ * workers, or conversations. One-shots are never pals. A pal
+ * currently working stays on the right only. Drawer Subagents rows are
+ * unfinished Calls; settled Calls stay off that list. A tape mention
+ * still resolves through `mentionedAgentCall`, including a settled Call.
+ */
+import { recordString } from "@inhuman.tools/harness-model/json-record";
+import { isConversationOverview, occupiedSessionIds, } from "@inhuman.tools/harness-model/kernel";
+import { AgentCallJob, CallJob, isNoteClaimed, ProgrammaticJob, SessionTurn, reactChunks, BotCallJob, } from "@inhuman.tools/harness-model/session";
+import { comparer, computed } from "mobx";
+import { ClientAgent } from "./client-agents.js";
+/** Ceiling for this-project conversations in the drawer. Not a visible-row target. */
+export const DRAWER_RECENT_SESSION_LIMIT = 20;
+/** U+25B8. Text play — resident background work. Not emoji. */
+export const SESSION_FACE_PLAY = "▸";
+/** U+2016. Text pause — parked leftover work. Not emoji. */
+export const SESSION_FACE_PAUSE = "‖";
+/** Occupied ask. Paint is `attention` — same hue as the always-approve chip. */
+export const SESSION_FACE_ASK = "awaiting approval";
+/** Speech-question pin. Not license cover. */
+export const SESSION_FACE_QUESTION = "has a question";
+const turnCallChunksCache = new WeakMap();
+function turnCallChunks(turn) {
+    let box = turnCallChunksCache.get(turn);
+    if (box === undefined) {
+        box = computed(() => {
+            const out = [];
+            for (const chunk of reactChunks(turn)) {
+                if (chunk instanceof CallJob) {
+                    out.push(chunk);
+                }
+                else if (chunk instanceof ProgrammaticJob && chunk.toolCalls.some((inner) => inner instanceof CallJob)) {
+                    out.push(chunk);
+                }
+            }
+            return out;
+        }, { equals: comparer.shallow });
+        turnCallChunksCache.set(turn, box);
+    }
+    return box.get();
+}
+export function projectAgentDrawer(client) {
+    const seen = new Set();
+    const calls = [];
+    for (const turn of tapeTurns(client)) {
+        for (const chunk of turnCallChunks(turn)) {
+            if (chunk instanceof ProgrammaticJob) {
+                const nested = [];
+                for (const inner of chunk.toolCalls) {
+                    if (!(inner instanceof CallJob))
+                        continue;
+                    if (seen.has(inner))
+                        continue;
+                    seen.add(inner);
+                    nested.push(projectCall(client, inner));
+                }
+                if (nested.length === 0)
+                    continue;
+                const expr = chunk.expr.trim();
+                const toolName = typeof chunk.toolName === "string" ? chunk.toolName.trim() : "";
+                const name = expr !== "" && expr !== "()" ? expr : toolName === "" || toolName === "scheme_repl" ? "scheme" : toolName;
+                calls.push({
+                    kind: "program",
+                    program: { key: `program:${chunk.toolCallId}`, name, children: nested },
+                });
+                continue;
+            }
+            if (!(chunk instanceof CallJob))
+                continue;
+            if (seen.has(chunk))
+                continue;
+            seen.add(chunk);
+            calls.push({ kind: "call", call: projectCall(client, chunk) });
+        }
+    }
+    for (const leftover of client.agentCalls) {
+        if (seen.has(leftover))
+            continue;
+        seen.add(leftover);
+        calls.push({ kind: "call", call: projectCall(client, leftover) });
+    }
+    return { calls, collaborators: projectCollaborators(client), sessions: projectRecentSessions(client) };
+}
+/** Call row for a tape mention. Settled calls stay off `flattenAgentDrawer` and still resolve. */
+export function mentionedAgentCall(client, key) {
+    if (!key.startsWith("call:") || key.length === "call:".length)
+        return null;
+    const walk = (call) => {
+        if (call.key === key)
+            return call;
+        for (const child of call.children) {
+            const hit = walk(child);
+            if (hit != null)
+                return hit;
+        }
+        return null;
+    };
+    for (const node of projectAgentDrawer(client).calls) {
+        const roots = node.kind === "program" ? node.program.children : [node.call];
+        for (const call of roots) {
+            const hit = walk(call);
+            if (hit != null)
+                return { key: hit.key, sessionId: hit.sessionId };
+        }
+    }
+    return null;
+}
+export function flattenAgentDrawer(proj) {
+    const rows = [];
+    const emit = (call, indent) => {
+        const live = !call.completed;
+        if (live)
+            rows.push(callRow(call, indent));
+        const next = live ? indent + 1 : indent;
+        for (const child of call.children)
+            emit(child, next);
+    };
+    for (const node of proj.calls) {
+        if (node.kind === "program") {
+            for (const call of node.program.children)
+                emit(call, 0);
+            continue;
+        }
+        emit(node.call, 0);
+    }
+    for (const bot of proj.collaborators) {
+        rows.push({
+            key: bot.key,
+            kind: "bot",
+            spec: bot.spec,
+            recap: bot.status,
+            indent: 0,
+            prompt: bot.prompt,
+            notifies: bot.notifies,
+            result: bot.result,
+            tempo: bot.tempo,
+            model: "",
+            mark: "",
+            lastPrompt: "",
+            askLine: "",
+            unfinished: "",
+            current: false,
+            sessionId: bot.sessionId,
+        });
+    }
+    for (const session of proj.sessions) {
+        rows.push({
+            key: session.key,
+            kind: "session",
+            spec: session.title,
+            recap: session.status,
+            indent: 0,
+            prompt: "",
+            notifies: [],
+            result: "",
+            tempo: session.tempo,
+            model: session.model,
+            mark: session.mark,
+            lastPrompt: session.lastPrompt,
+            askLine: session.askLine,
+            unfinished: session.unfinished,
+            current: session.current,
+            sessionId: session.sessionId,
+        });
+    }
+    return rows;
+}
+export function projectRecentSessions(client) {
+    const occupied = occupiedSessionIds(client.kernelPlexus.awareness);
+    const rows = [];
+    for (const id of Object.keys(client.projectRoot.sessions)) {
+        const sessionId = id.trim();
+        if (sessionId === "")
+            continue;
+        const glance = client.kernelRoot.sessions[sessionId];
+        if (!isConversationOverview(glance))
+            continue;
+        const title = fieldText(glance.title);
+        const status = fieldText(glance.status);
+        const current = sessionId === client.sessionId;
+        // Intern stamps lastMessageAt. Title is first prompt / rename / metadata;
+        // status is update_metadata. Either means a session happened.
+        if (title === "" && status === "")
+            continue;
+        const unfinished = unfinishedOf(glance);
+        rows.push({
+            key: `session:${sessionId}`,
+            sessionId,
+            title: title === "" ? sessionId : title,
+            status,
+            lastMessageAt: typeof glance.lastMessageAt === "number" && Number.isFinite(glance.lastMessageAt) ? glance.lastMessageAt : 0,
+            occupied: occupied.has(sessionId),
+            resident: glance.resident === true,
+            periodArmed: glance.periodArmed === true,
+            openTurn: glance.openTurn === true,
+            openToolCount: fieldCount(glance.openToolCount),
+            unfinished,
+            lastPrompt: fieldText(glance.lastPrompt),
+            askLine: unfinished === "question" ? fieldText(glance.questionLine) : fieldText(glance.askLine),
+            current,
+            tempo: glance.asking === true || unfinished === "question"
+                ? "blocked"
+                : glance.midMotion === true ||
+                    glance.openTurn === true ||
+                    fieldCount(glance.openToolCount) > 0 ||
+                    fieldCount(glance.openCallbackCount) > 0
+                    ? "active"
+                    : "idle",
+            model: fieldText(glance.model),
+            mark: sessionOverviewMark({
+                current,
+                occupied: occupied.has(sessionId),
+                resident: glance.resident === true,
+                unfinished: unfinishedOf(glance),
+                periodArmed: glance.periodArmed === true,
+            }),
+        });
+    }
+    rows.sort((a, b) => b.lastMessageAt - a.lastMessageAt || a.sessionId.localeCompare(b.sessionId));
+    return rows.slice(0, DRAWER_RECENT_SESSION_LIMIT);
+}
+function fieldText(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+function fieldCount(value) {
+    return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : 0;
+}
+function unfinishedOf(glance) {
+    const stamped = glance.unfinished;
+    switch (true) {
+        case stamped === "ask":
+        case stamped === "tools":
+        case stamped === "turn":
+        case stamped === "question":
+            return stamped;
+        case glance.asking === true:
+            return "ask";
+        case fieldCount(glance.openToolCount) > 0:
+            return "tools";
+        case glance.openTurn === true:
+            return "turn";
+        case glance.midMotion === true && glance.periodArmed !== true:
+            return "tools";
+        default:
+            return "";
+    }
+}
+export function sessionOverviewMark(input) {
+    switch (true) {
+        case input.current:
+            return "this session";
+        case input.unfinished === "question":
+            return SESSION_FACE_QUESTION;
+        case input.occupied && input.unfinished === "ask":
+            return SESSION_FACE_ASK;
+        case input.occupied && input.unfinished !== "":
+            return "active";
+        case input.occupied:
+            return "idle";
+        case input.unfinished !== "" && input.resident:
+            return SESSION_FACE_PLAY;
+        case input.unfinished !== "":
+            return SESSION_FACE_PAUSE;
+        case input.resident && input.periodArmed:
+            return "bot";
+        default:
+            return "";
+    }
+}
+export function projectAgentMeter(client, proj = projectAgentDrawer(client)) {
+    const pals = new Set(proj.collaborators.map((bot) => bot.sessionId));
+    const live = [];
+    for (const node of proj.calls) {
+        const bag = node.kind === "program" ? node.program.children : [node.call];
+        for (const call of bag) {
+            if (call.completed)
+                continue;
+            if (call.tempo !== "active" && call.tempo !== "blocked")
+                continue;
+            if (call.sessionId !== "" && pals.has(call.sessionId))
+                continue;
+            live.push(call.spec);
+        }
+    }
+    if (live.length === 0 && proj.collaborators.length === 0)
+        return null;
+    const groups = [];
+    const index = new Map();
+    for (const spec of live) {
+        const name = spec.trim() === "" ? "agent" : spec;
+        const at = index.get(name);
+        if (at === undefined) {
+            index.set(name, groups.length);
+            groups.push({ spec: name, count: 1 });
+        }
+        else {
+            groups[at] = { spec: name, count: groups[at].count + 1 };
+        }
+    }
+    return { calls: groups, bots: proj.collaborators.map((bot) => bot.spec) };
+}
+function callRow(call, indent) {
+    return {
+        key: call.key,
+        kind: "call",
+        spec: call.spec,
+        recap: call.status,
+        indent,
+        prompt: call.prompt,
+        notifies: call.notifies,
+        result: call.result,
+        tempo: call.tempo,
+        model: call.model,
+        mark: call.mark,
+        lastPrompt: call.lastPrompt,
+        askLine: call.askLine,
+        unfinished: call.unfinished,
+        current: false,
+        sessionId: call.sessionId,
+    };
+}
+function projectCall(client, call) {
+    const sessionId = call.workerSessionId.trim();
+    const spec = recordString(call.args, "spec");
+    const bot = call instanceof BotCallJob ? call.botName.trim() || call.contributionBotName.trim() : "";
+    const face = workerFace(client, sessionId, call.completed);
+    const faceName = call instanceof AgentCallJob ? fieldText(call.faceName) : "";
+    return {
+        key: `call:${call.toolCallId}`,
+        spec: spec === "" ? (bot === "" ? face.specName || faceName || "agent" : bot) : spec,
+        tempo: face.tempo,
+        status: face.status,
+        prompt: spawnPrompt(call),
+        notifies: notifyLines(call),
+        result: resultText(call),
+        sessionId,
+        oneShot: call instanceof AgentCallJob,
+        completed: call.completed,
+        model: face.model,
+        lastPrompt: face.lastPrompt,
+        askLine: face.askLine,
+        unfinished: face.unfinished,
+        mark: face.mark,
+        children: kernelChildren(client, sessionId, new Set([client.sessionId])),
+    };
+}
+function kernelChildren(client, callerSessionId, path) {
+    if (callerSessionId === "" || path.has(callerSessionId))
+        return [];
+    const nextPath = new Set(path);
+    nextPath.add(callerSessionId);
+    const out = [];
+    const bag = client.kernelRoot.agentCalls;
+    for (const id of Object.keys(bag).sort()) {
+        const rel = bag[id];
+        if (rel == null || rel.callerSessionId !== callerSessionId)
+            continue;
+        if (nextPath.has(rel.workerSessionId.trim()))
+            continue;
+        const row = projectRelation(client, id, rel, nextPath);
+        if (row != null)
+            out.push(row);
+    }
+    return out;
+}
+function projectRelation(client, id, rel, path) {
+    const worker = rel.workerSessionId.trim();
+    if (worker === "")
+        return null;
+    const spec = rel.spec.trim();
+    const face = workerFace(client, worker, rel.completed);
+    return {
+        key: `call:${id}`,
+        spec: spec === "" ? "agent" : spec,
+        tempo: face.tempo,
+        status: face.status,
+        prompt: "",
+        notifies: [],
+        result: "",
+        sessionId: worker,
+        oneShot: rel.oneShot,
+        completed: rel.completed,
+        model: face.model,
+        lastPrompt: face.lastPrompt,
+        askLine: face.askLine,
+        unfinished: face.unfinished,
+        mark: face.mark,
+        children: kernelChildren(client, worker, path),
+    };
+}
+function workerFace(client, sessionId, completed) {
+    const agent = sessionId === "" ? null : new ClientAgent(client, sessionId);
+    const glance = agent?.overview ?? null;
+    const unfinished = glance == null ? "" : unfinishedOf(glance);
+    const tempo = completed ? "idle" : (agent?.tempo ?? "active");
+    return {
+        tempo,
+        status: agent?.status ?? "",
+        model: agent?.model ?? "",
+        lastPrompt: fieldText(glance?.lastPrompt),
+        askLine: unfinished === "question" ? fieldText(glance?.questionLine) : fieldText(glance?.askLine),
+        unfinished,
+        mark: callGlanceMark({ unfinished, tempo }),
+        specName: fieldText(glance?.specName) || (agent?.specName ?? ""),
+    };
+}
+function callGlanceMark(input) {
+    if (input.unfinished === "question")
+        return SESSION_FACE_QUESTION;
+    if (input.unfinished === "ask" || input.tempo === "blocked")
+        return SESSION_FACE_ASK;
+    if (input.tempo === "active")
+        return "active";
+    return "";
+}
+function projectCollaborators(client) {
+    const seen = new Set();
+    const out = [];
+    const take = (agent) => {
+        if (agent.sessionId === "" || seen.has(agent.sessionId))
+            return;
+        seen.add(agent.sessionId);
+        if (!isCollaborator(client, agent))
+            return;
+        const last = agent.lastCall;
+        const spec = isConversationOverview(agent.overview)
+            ? agent.title.trim() || agent.specName
+            : agent.specName.trim() || agent.title;
+        out.push({
+            key: `bot:${agent.sessionId}`,
+            sessionId: agent.sessionId,
+            spec,
+            tempo: agent.tempo,
+            status: agent.status,
+            keepAlive: agent.keepAlive,
+            prompt: last == null ? "" : spawnPrompt(last),
+            notifies: last == null ? [] : notifyLines(last),
+            result: last == null ? "" : resultText(last),
+        });
+    };
+    for (const agent of client.agents)
+        take(agent);
+    for (const call of client.agentCalls) {
+        const id = call.workerSessionId.trim();
+        if (id === "" || seen.has(id))
+            continue;
+        take(new ClientAgent(client, id));
+    }
+    return out;
+}
+function isCollaborator(client, agent) {
+    if (agent.sessionId === client.sessionId)
+        return false;
+    if (!agent.interacted)
+        return false;
+    if (agent.oneShot)
+        return false;
+    if (agent.keepAlive)
+        return true;
+    return isConversationOverview(agent.overview) && agent.sessionId in client.projectRoot.sessions;
+}
+function tapeTurns(client) {
+    const spine = [];
+    const seen = new Set();
+    let cell = client.sessionRoot.head;
+    while (cell !== null && !seen.has(cell)) {
+        seen.add(cell);
+        if (cell instanceof SessionTurn)
+            spine.push(cell);
+        cell = cell.turnTail;
+    }
+    spine.reverse();
+    return spine;
+}
+function spawnPrompt(call) {
+    return recordString(call.args, "message");
+}
+function notifyLines(call) {
+    const out = [];
+    for (const note of call.notifications) {
+        if (isNoteClaimed(note))
+            continue;
+        const message = note.message.trim();
+        if (message !== "")
+            out.push(message);
+    }
+    return out;
+}
+function resultText(call) {
+    if (!call.completed)
+        return "";
+    const payload = call.observationPayload();
+    if (typeof payload === "string")
+        return payload;
+    if (payload == null)
+        return "";
+    return String(payload);
+}
+//# sourceMappingURL=client-agents-tree.js.map