@geminixiang/mikan 1.0.0-beta.9 → 1.0.0-beta.91

package/dist/harness/tools/history.js

@@ -0,0 +1,293 @@
+import { contentText } from "@earendil-works/pi-ai";
+import { Type } from "typebox";
+import { readConversationLog } from "../../sessions/chat-history-sync.js";
+import { formatHistoryLine, formatLocalTimestamp } from "../../sessions/history-line.js";
+import { SessionStore, isEarlierSessionKey } from "../../sessions/session-store.js";
+import { isThreadSessionKey, threadSuffixOf } from "../../sessions/session-key.js";
+import { LABEL_PARAMETER } from "./host-fn-tool.js";
+const HISTORY_TOOL = "history";
+const DEFAULT_LIMIT = 20;
+const MAX_LIMIT = 200;
+const MAX_ENTRY_CHARS = 2000;
+const MAX_OUTPUT_CHARS = 30_000;
+const SESSION_REF_MIN_CHARS = 8;
+const historySchema = Type.Object({
+    label: LABEL_PARAMETER,
+    action: Type.Union([Type.Literal("sessions"), Type.Literal("search"), Type.Literal("read"), Type.Literal("chat")], {
+        description: "sessions: list this conversation's sessions. search: find text in session entries, including tool calls and output. read: read one session in order. chat: search the chat log, including messages you never answered.",
+    }),
+    query: Type.Optional(Type.String({
+        description: "Case-insensitive words that must all appear in an entry; a Chinese or Japanese word also matches when most of its character pairs appear (search and chat; optional for chat)",
+    })),
+    session: Type.Optional(Type.String({
+        description: `Session id from the sessions action (first ${SESSION_REF_MIN_CHARS}+ characters are enough), or "current". read defaults to current; search defaults to every session.`,
+    })),
+    limit: Type.Optional(Type.Integer({
+        minimum: 1,
+        maximum: MAX_LIMIT,
+        description: `How many of the newest results to return (default ${DEFAULT_LIMIT}; sessions lists up to ${MAX_LIMIT})`,
+    })),
+    skip: Type.Optional(Type.Integer({
+        minimum: 0,
+        description: "Newest results to skip, to page back to older ones",
+    })),
+});
+function isScopeSession(info, scope) {
+    return info.key === scope.sessionKey;
+}
+async function listOfficeSessions(office) {
+    return (await SessionStore.list(office)).toSorted((a, b) => b.createdAt - a.createdAt);
+}
+function clip(text, max = MAX_ENTRY_CHARS) {
+    return text.length <= max ? text : `${text.slice(0, max)}… (${text.length - max} more chars)`;
+}
+function formatTime(ms) {
+    return formatLocalTimestamp(new Date(ms)) ?? String(ms);
+}
+function recordOf(entryId) {
+    return entryId.slice(entryId.lastIndexOf(":") + 1);
+}
+function toolResultText(message) {
+    return `[${message.toolName}${message.isError ? " error" : ""}] ${contentText(message.content, "\n")}`;
+}
+function messageText(message, results) {
+    switch (message.role) {
+        case "user":
+            return `[user] ${contentText(message.content, "\n")}`;
+        case "assistant": {
+            const parts = message.content.flatMap((part) => {
+                if (part.type === "text")
+                    return [part.text];
+                if (part.type !== "toolCall" || part.name === HISTORY_TOOL)
+                    return [];
+                const call = `→ ${part.name} ${JSON.stringify(part.arguments)}`;
+                const result = results.get(part.id);
+                return [result ? `${call}\n← ${toolResultText(result)}` : call];
+            });
+            return parts.length > 0 ? `[assistant] ${parts.join("\n")}` : undefined;
+        }
+        case "toolResult":
+            return message.toolName === HISTORY_TOOL ? undefined : toolResultText(message);
+        default:
+            return undefined;
+    }
+}
+function historyEntries(entries) {
+    const calls = new Set();
+    const results = new Map();
+    for (const entry of entries) {
+        if (entry.type !== "message")
+            continue;
+        if (entry.message.role === "toolResult")
+            results.set(entry.message.toolCallId, entry.message);
+        if (entry.message.role !== "assistant")
+            continue;
+        for (const part of entry.message.content)
+            if (part.type === "toolCall")
+                calls.add(part.id);
+    }
+    return entries.flatMap((entry) => {
+        switch (entry.type) {
+            case "message": {
+                const { message } = entry;
+                if (message.role === "toolResult" && calls.has(message.toolCallId))
+                    return [];
+                const text = messageText(message, results);
+                return text ? [{ record: recordOf(entry.id), timestamp: entry.timestamp, text }] : [];
+            }
+            case "compaction":
+                return [
+                    {
+                        record: recordOf(entry.id),
+                        timestamp: entry.timestamp,
+                        text: `[summary] ${entry.summary}`,
+                    },
+                ];
+            case "custom":
+                return [];
+        }
+    });
+}
+const CJK_CHARACTER = /[\u3040-\u30ff\u3400-\u9fff\uac00-\ud7af]/;
+function wordMatches(text, word) {
+    if (text.includes(word))
+        return true;
+    const characters = Array.from(word);
+    if (characters.length < 3 || !CJK_CHARACTER.test(word))
+        return false;
+    const pairs = characters.slice(1).map((character, index) => `${characters[index]}${character}`);
+    return pairs.filter((pair) => text.includes(pair)).length * 2 >= pairs.length;
+}
+function matches(text, query) {
+    if (!query)
+        return true;
+    const lower = text.toLowerCase();
+    return query.split(/\s+/).every((word) => wordMatches(lower, word));
+}
+function entryLine(entry) {
+    return `(${formatTime(entry.timestamp)}) ${clip(entry.text)}`;
+}
+function newestPage(items, args) {
+    const end = Math.max(items.length - (args.skip ?? 0), 0);
+    return items.slice(Math.max(end - (args.limit ?? DEFAULT_LIMIT), 0), end);
+}
+function bounded(header, lines, skip) {
+    const kept = [];
+    let length = header.length;
+    for (const line of lines.toReversed()) {
+        if (length + line.length > MAX_OUTPUT_CHARS)
+            break;
+        kept.unshift(line);
+        length += line.length;
+    }
+    const dropped = lines.length - kept.length;
+    const note = dropped > 0
+        ? [`(${dropped} older results omitted by the output limit; use skip=${skip + kept.length})`]
+        : [];
+    return [header, ...note, ...kept].join("\n\n");
+}
+function sessionKind(info) {
+    if (info.root)
+        return "main, current";
+    return isEarlierSessionKey(info.key) ? "earlier session" : "thread";
+}
+function sessionLabel(info, titles) {
+    const suffix = isThreadSessionKey(info.key) ? threadSuffixOf(info.key) : undefined;
+    const title = suffix ? titles.get(suffix) : undefined;
+    const parent = info.parentSessionId
+        ? ` parent=${info.parentSessionId.slice(0, SESSION_REF_MIN_CHARS)}`
+        : "";
+    return `${info.id} (${sessionKind(info)}, ${formatTime(info.createdAt)}${parent})${title ? ` ${clip(title, 120)}` : ""}`;
+}
+function scopeTitles(office) {
+    const titles = new Map();
+    for (const { message } of readConversationLog(office)) {
+        const firstLine = message.text
+            ?.split("\n")
+            .find((line) => line.trim())
+            ?.trim();
+        if (message.ts && firstLine) {
+            titles.set(message.ts, `[${message.userName ?? message.user ?? "unknown"}]: ${firstLine}`);
+        }
+    }
+    return titles;
+}
+function resolveSession(sessions, scope, ref) {
+    if (ref === "current") {
+        return (sessions.find((info) => isScopeSession(info, scope)) ??
+            "The current session has not started yet.");
+    }
+    if (ref.length < SESSION_REF_MIN_CHARS) {
+        return `Use at least ${SESSION_REF_MIN_CHARS} characters of a session id.`;
+    }
+    const found = sessions.filter((info) => info.id.startsWith(ref));
+    const [only] = found;
+    if (found.length === 1 && only)
+        return only;
+    return found.length === 0
+        ? `No session in this conversation starts with "${ref}". Use the sessions action to list them.`
+        : `"${ref}" matches ${found.length} sessions; use more characters.`;
+}
+async function listSessions(scope, args) {
+    const sessions = await listOfficeSessions(scope.office);
+    if (sessions.length === 0)
+        return "This conversation has no sessions yet.";
+    const titles = scopeTitles(scope.office);
+    const lines = sessions
+        .map((info) => `${isScopeSession(info, scope) ? "* " : ""}${sessionLabel(info, titles)}`)
+        .toReversed();
+    return bounded(`${sessions.length} sessions in this conversation, oldest first; * marks this one.`, newestPage(lines, { ...args, limit: args.limit ?? MAX_LIMIT }), args.skip ?? 0);
+}
+async function sessionEntries(office, info) {
+    const inspection = await SessionStore.inspect(office, info.key);
+    return inspection ? historyEntries(await inspection.getEntries()) : [];
+}
+async function readSession(scope, args) {
+    const sessions = await listOfficeSessions(scope.office);
+    const info = resolveSession(sessions, scope, args.session ?? "current");
+    if (typeof info === "string")
+        return info;
+    const query = args.query?.trim().toLowerCase();
+    const found = (await sessionEntries(scope.office, info)).filter((entry) => matches(entry.text, query));
+    if (found.length === 0) {
+        return query ? `No entries match "${args.query}".` : "The session is empty.";
+    }
+    const page = newestPage(found, args);
+    return bounded(`Session ${sessionLabel(info, scopeTitles(scope.office))}: ${found.length} entries; ${page.length} newest shown, oldest first.`, page.map(entryLine), args.skip ?? 0);
+}
+async function searchSessions(scope, args) {
+    const query = args.query?.trim().toLowerCase();
+    if (!query)
+        return "search needs a query; use read to page through a session.";
+    const sessions = await listOfficeSessions(scope.office);
+    const selected = args.session ? resolveSession(sessions, scope, args.session) : undefined;
+    if (typeof selected === "string")
+        return selected;
+    const titles = scopeTitles(scope.office);
+    const results = [];
+    const seen = new Set();
+    for (const info of selected ? [selected] : sessions.toReversed()) {
+        for (const entry of await sessionEntries(scope.office, info)) {
+            if (seen.has(entry.record))
+                continue;
+            seen.add(entry.record);
+            if (matches(entry.text, query))
+                results.push({ ...entry, session: info });
+        }
+    }
+    if (results.length === 0)
+        return `No session entries match "${args.query}".`;
+    const page = newestPage(results.toSorted((a, b) => a.timestamp - b.timestamp), args);
+    const lines = page.map((result, index) => {
+        const line = entryLine(result);
+        return page[index - 1]?.session === result.session
+            ? line
+            : `## session ${sessionLabel(result.session, titles)}\n${line}`;
+    });
+    const sessionCount = new Set(results.map((result) => result.session)).size;
+    return bounded(`${results.length} matching entries in ${sessionCount} sessions; ${page.length} newest shown, oldest first, grouped by session.`, lines, args.skip ?? 0);
+}
+function searchChat(scope, args) {
+    const query = args.query?.trim().toLowerCase();
+    const lines = readConversationLog(scope.office)
+        .map(({ message }) => formatHistoryLine({
+        date: message.date ? new Date(message.date) : undefined,
+        userName: message.userName ?? message.user,
+        threadTs: message.threadTs,
+        text: message.text ?? "",
+    }))
+        .filter((line) => matches(line, query));
+    if (lines.length === 0) {
+        return query ? `No chat messages match "${args.query}".` : "The chat log is empty.";
+    }
+    const page = newestPage(lines, args);
+    return bounded(`${lines.length} ${query ? "matching " : ""}chat messages; ${page.length} newest shown, oldest first.`, page.map((line) => clip(line)), args.skip ?? 0);
+}
+export async function runHistory(scope, args) {
+    switch (args.action) {
+        case "sessions":
+            return listSessions(scope, args);
+        case "search":
+            return searchSessions(scope, args);
+        case "read":
+            return readSession(scope, args);
+        case "chat":
+            return searchChat(scope, args);
+    }
+}
+export function createHistoryTool(scope) {
+    return {
+        name: HISTORY_TOOL,
+        label: HISTORY_TOOL,
+        description: "Look back through this conversation's history beyond your context: its sessions (the channel or DM session, earlier ones replaced by /new, and its threads), their messages, your tool calls and their output, and the chat log. Read an earlier result here instead of rerunning its command. Other conversations are not reachable.",
+        parameters: historySchema,
+        execute: async (_toolCallId, { label: _label, ...args }, signal) => {
+            signal?.throwIfAborted();
+            return {
+                content: [{ type: "text", text: await runHistory(scope, args) }],
+                details: undefined,
+            };
+        },
+    };
+}
+//# sourceMappingURL=history.js.map

package/dist/harness/tools/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../../src/harness/tools/history.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAA0B,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,IAAI,EAAe,MAAM,SAAS,CAAC;AAE5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACzF,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEnF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,YAAY,GAAG,SAAS,CAAC;AAC/B,MAAM,aAAa,GAAG,EAAE,CAAC;AACzB,MAAM,SAAS,GAAG,GAAG,CAAC;AACtB,MAAM,eAAe,GAAG,IAAI,CAAC;AAC7B,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAChC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAEhC,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC;IAChC,KAAK,EAAE,eAAe;IACtB,MAAM,EAAE,IAAI,CAAC,KAAK,CAChB,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAC9F;QACE,WAAW,EACT,wNAAwN;KAC3N,CACF;IACD,KAAK,EAAE,IAAI,CAAC,QAAQ,CAClB,IAAI,CAAC,MAAM,CAAC;QACV,WAAW,EACT,+KAA+K;KAClL,CAAC,CACH;IACD,OAAO,EAAE,IAAI,CAAC,QAAQ,CACpB,IAAI,CAAC,MAAM,CAAC;QACV,WAAW,EAAE,8CAA8C,qBAAqB,qGAAqG;KACtL,CAAC,CACH;IACD,KAAK,EAAE,IAAI,CAAC,QAAQ,CAClB,IAAI,CAAC,OAAO,CAAC;QACX,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,SAAS;QAClB,WAAW,EAAE,qDAAqD,aAAa,0BAA0B,SAAS,GAAG;KACtH,CAAC,CACH;IACD,IAAI,EAAE,IAAI,CAAC,QAAQ,CACjB,IAAI,CAAC,OAAO,CAAC;QACX,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,oDAAoD;KAClE,CAAC,CACH;CACF,CAAC,CAAC;AASH,SAAS,cAAc,CAAC,IAAoB,EAAE,KAAmB;IAC/D,OAAO,IAAI,CAAC,GAAG,KAAK,KAAK,CAAC,UAAU,CAAC;AACvC,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,MAAc;IAC9C,OAAO,CAAC,MAAM,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;AACzF,CAAC;AAED,SAAS,IAAI,CAAC,IAAY,EAAE,GAAG,GAAG,eAAe;IAC/C,OAAO,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,GAAG,GAAG,cAAc,CAAC;AAChG,CAAC;AAED,SAAS,UAAU,CAAC,EAAU;IAC5B,OAAO,oBAAoB,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC;AAC1D,CAAC;AAQD,SAAS,QAAQ,CAAC,OAAe;IAC/B,OAAO,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,cAAc,CAAC,OAA0B;IAChD,OAAO,IAAI,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC;AACzG,CAAC;AAED,SAAS,WAAW,CAClB,OAAqB,EACrB,OAA+C;IAE/C,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,MAAM;YACT,OAAO,UAAU,WAAW,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC;QACxD,KAAK,WAAW,EAAE,CAAC;YACjB,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;gBAC7C,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;oBAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC7C,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY;oBAAE,OAAO,EAAE,CAAC;gBACtE,MAAM,IAAI,GAAG,KAAK,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;gBAChE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACpC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,OAAO,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAClE,CAAC,CAAC,CAAC;YACH,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1E,CAAC;QACD,KAAK,YAAY;YACf,OAAO,OAAO,CAAC,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QACjF;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,OAAgC;IACtD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,MAAM,OAAO,GAAG,IAAI,GAAG,EAA6B,CAAC;IACrD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;YAAE,SAAS;QACvC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,YAAY;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QAC9F,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,WAAW;YAAE,SAAS;QACjD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO;YAAE,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU;gBAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7F,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QAC/B,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,SAAS,EAAE,CAAC;gBACf,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;gBAC1B,IAAI,OAAO,CAAC,IAAI,KAAK,YAAY,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC;oBAAE,OAAO,EAAE,CAAC;gBAC9E,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC3C,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACxF,CAAC;YACD,KAAK,YAAY;gBACf,OAAO;oBACL;wBACE,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;wBAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;wBAC1B,IAAI,EAAE,aAAa,KAAK,CAAC,OAAO,EAAE;qBACnC;iBACF,CAAC;YACJ,KAAK,QAAQ;gBACX,OAAO,EAAE,CAAC;QACd,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,aAAa,GAAG,2CAA2C,CAAC;AAElE,SAAS,WAAW,CAAC,IAAY,EAAE,IAAY;IAC7C,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACrE,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,SAAS,EAAE,CAAC,CAAC;IAChG,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC;AAChF,CAAC;AAED,SAAS,OAAO,CAAC,IAAY,EAAE,KAAyB;IACtD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,SAAS,CAAC,KAAmB;IACpC,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;AAChE,CAAC;AAED,SAAS,UAAU,CAAI,KAAmB,EAAE,IAAiB;IAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACzD,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,aAAa,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC5E,CAAC;AAED,SAAS,OAAO,CAAC,MAAc,EAAE,KAAwB,EAAE,IAAY;IACrE,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,UAAU,EAAE,EAAE,CAAC;QACtC,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,gBAAgB;YAAE,MAAM;QACnD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACnB,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC;IACxB,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3C,MAAM,IAAI,GACR,OAAO,GAAG,CAAC;QACT,CAAC,CAAC,CAAC,IAAI,OAAO,wDAAwD,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC;QAC5F,CAAC,CAAC,EAAE,CAAC;IACT,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,WAAW,CAAC,IAAoB;IACvC,IAAI,IAAI,CAAC,IAAI;QAAE,OAAO,eAAe,CAAC;IACtC,OAAO,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,QAAQ,CAAC;AACtE,CAAC;AAED,SAAS,YAAY,CAAC,IAAoB,EAAE,MAAmC;IAC7E,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACnF,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtD,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe;QACjC,CAAC,CAAC,WAAW,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,qBAAqB,CAAC,EAAE;QACnE,CAAC,CAAC,EAAE,CAAC;IACP,OAAO,GAAG,IAAI,CAAC,EAAE,KAAK,WAAW,CAAC,IAAI,CAAC,KAAK,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAC3H,CAAC;AAED,SAAS,WAAW,CAAC,MAAc;IACjC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,EAAE,OAAO,EAAE,IAAI,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;QACtD,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI;YAC5B,EAAE,KAAK,CAAC,IAAI,CAAC;aACZ,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,EAAE,IAAI,EAAE,CAAC;QACX,IAAI,OAAO,CAAC,EAAE,IAAI,SAAS,EAAE,CAAC;YAC5B,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,IAAI,SAAS,MAAM,SAAS,EAAE,CAAC,CAAC;QAC7F,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,cAAc,CACrB,QAAmC,EACnC,KAAmB,EACnB,GAAW;IAEX,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,CACL,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACpD,0CAA0C,CAC3C,CAAC;IACJ,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,GAAG,qBAAqB,EAAE,CAAC;QACvC,OAAO,gBAAgB,qBAAqB,8BAA8B,CAAC;IAC7E,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IACjE,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACrB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAC5C,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;QACvB,CAAC,CAAC,gDAAgD,GAAG,0CAA0C;QAC/F,CAAC,CAAC,IAAI,GAAG,aAAa,KAAK,CAAC,MAAM,iCAAiC,CAAC;AACxE,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,KAAmB,EAAE,IAAiB;IAChE,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,wCAAwC,CAAC;IAC3E,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,QAAQ;SACnB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;SACxF,UAAU,EAAE,CAAC;IAChB,OAAO,OAAO,CACZ,GAAG,QAAQ,CAAC,MAAM,iEAAiE,EACnF,UAAU,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,SAAS,EAAE,CAAC,EAC9D,IAAI,CAAC,IAAI,IAAI,CAAC,CACf,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,MAAc,EAAE,IAAoB;IAChE,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAChE,OAAO,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACzE,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,KAAmB,EAAE,IAAiB;IAC/D,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,cAAc,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,IAAI,SAAS,CAAC,CAAC;IACxE,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC/C,MAAM,KAAK,GAAG,CAAC,MAAM,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CACxE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAC3B,CAAC;IACF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC,CAAC,CAAC,qBAAqB,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,uBAAuB,CAAC;IAC/E,CAAC;IACD,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACrC,OAAO,OAAO,CACZ,WAAW,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,KAAK,CAAC,MAAM,aAAa,IAAI,CAAC,MAAM,8BAA8B,EAC/H,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EACnB,IAAI,CAAC,IAAI,IAAI,CAAC,CACf,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,KAAmB,EAAE,IAAiB;IAClE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC/C,IAAI,CAAC,KAAK;QAAE,OAAO,2DAA2D,CAAC;IAC/E,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1F,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAClD,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,OAAO,GAAsD,EAAE,CAAC;IACtE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC;QACjE,KAAK,MAAM,KAAK,IAAI,MAAM,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;YAC7D,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC;gBAAE,SAAS;YACrC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACvB,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5E,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,6BAA6B,IAAI,CAAC,KAAK,IAAI,CAAC;IAC7E,MAAM,IAAI,GAAG,UAAU,CACrB,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,EACrD,IAAI,CACL,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QACvC,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,OAAO,KAAK,MAAM,CAAC,OAAO;YAChD,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,cAAc,YAAY,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IACpE,CAAC,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3E,OAAO,OAAO,CACZ,GAAG,OAAO,CAAC,MAAM,wBAAwB,YAAY,cAAc,IAAI,CAAC,MAAM,kDAAkD,EAChI,KAAK,EACL,IAAI,CAAC,IAAI,IAAI,CAAC,CACf,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,KAAmB,EAAE,IAAiB;IACxD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC/C,MAAM,KAAK,GAAG,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC;SAC5C,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CACnB,iBAAiB,CAAC;QAChB,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;QACvD,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI;QAC1C,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;KACzB,CAAC,CACH;SACA,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAC1C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC,CAAC,CAAC,2BAA2B,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,wBAAwB,CAAC;IACtF,CAAC;IACD,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACrC,OAAO,OAAO,CACZ,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,kBAAkB,IAAI,CAAC,MAAM,8BAA8B,EACtG,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAC9B,IAAI,CAAC,IAAI,IAAI,CAAC,CACf,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAmB,EAAE,IAAiB;IACrE,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;QACpB,KAAK,UAAU;YACb,OAAO,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACnC,KAAK,QAAQ;YACX,OAAO,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACrC,KAAK,MAAM;YACT,OAAO,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAClC,KAAK,MAAM;YACT,OAAO,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAmB;IACnD,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,YAAY;QACnB,WAAW,EACT,uUAAuU;QACzU,UAAU,EAAE,aAAa;QACzB,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE;YACjE,MAAM,EAAE,cAAc,EAAE,CAAC;YACzB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;gBAChE,OAAO,EAAE,SAAS;aACnB,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { AgentMessage, AgentTool } from \"@earendil-works/pi-agent-core\";\nimport { contentText, type ToolResultMessage } from \"@earendil-works/pi-ai\";\nimport { Type, type Static } from \"typebox\";\nimport type { Office } from \"../../office/types.js\";\nimport { readConversationLog } from \"../../sessions/chat-history-sync.js\";\nimport { formatHistoryLine, formatLocalTimestamp } from \"../../sessions/history-line.js\";\nimport { SessionStore, isEarlierSessionKey } from \"../../sessions/session-store.js\";\nimport { isThreadSessionKey, threadSuffixOf } from \"../../sessions/session-key.js\";\nimport type { SessionEntry, SessionListing } from \"../../sessions/types.js\";\nimport { LABEL_PARAMETER } from \"./host-fn-tool.js\";\n\nconst HISTORY_TOOL = \"history\";\nconst DEFAULT_LIMIT = 20;\nconst MAX_LIMIT = 200;\nconst MAX_ENTRY_CHARS = 2000;\nconst MAX_OUTPUT_CHARS = 30_000;\nconst SESSION_REF_MIN_CHARS = 8;\n\nconst historySchema = Type.Object({\n  label: LABEL_PARAMETER,\n  action: Type.Union(\n    [Type.Literal(\"sessions\"), Type.Literal(\"search\"), Type.Literal(\"read\"), Type.Literal(\"chat\")],\n    {\n      description:\n        \"sessions: list this conversation's sessions. search: find text in session entries, including tool calls and output. read: read one session in order. chat: search the chat log, including messages you never answered.\",\n    },\n  ),\n  query: Type.Optional(\n    Type.String({\n      description:\n        \"Case-insensitive words that must all appear in an entry; a Chinese or Japanese word also matches when most of its character pairs appear (search and chat; optional for chat)\",\n    }),\n  ),\n  session: Type.Optional(\n    Type.String({\n      description: `Session id from the sessions action (first ${SESSION_REF_MIN_CHARS}+ characters are enough), or \"current\". read defaults to current; search defaults to every session.`,\n    }),\n  ),\n  limit: Type.Optional(\n    Type.Integer({\n      minimum: 1,\n      maximum: MAX_LIMIT,\n      description: `How many of the newest results to return (default ${DEFAULT_LIMIT}; sessions lists up to ${MAX_LIMIT})`,\n    }),\n  ),\n  skip: Type.Optional(\n    Type.Integer({\n      minimum: 0,\n      description: \"Newest results to skip, to page back to older ones\",\n    }),\n  ),\n});\n\ntype HistoryArgs = Omit<Static<typeof historySchema>, \"label\">;\n\ninterface HistoryScope {\n  office: Office;\n  sessionKey: string;\n}\n\nfunction isScopeSession(info: SessionListing, scope: HistoryScope): boolean {\n  return info.key === scope.sessionKey;\n}\n\nasync function listOfficeSessions(office: Office): Promise<SessionListing[]> {\n  return (await SessionStore.list(office)).toSorted((a, b) => b.createdAt - a.createdAt);\n}\n\nfunction clip(text: string, max = MAX_ENTRY_CHARS): string {\n  return text.length <= max ? text : `${text.slice(0, max)}… (${text.length - max} more chars)`;\n}\n\nfunction formatTime(ms: number): string {\n  return formatLocalTimestamp(new Date(ms)) ?? String(ms);\n}\n\ninterface HistoryEntry {\n  record: string;\n  timestamp: number;\n  text: string;\n}\n\nfunction recordOf(entryId: string): string {\n  return entryId.slice(entryId.lastIndexOf(\":\") + 1);\n}\n\nfunction toolResultText(message: ToolResultMessage): string {\n  return `[${message.toolName}${message.isError ? \" error\" : \"\"}] ${contentText(message.content, \"\\n\")}`;\n}\n\nfunction messageText(\n  message: AgentMessage,\n  results: ReadonlyMap<string, ToolResultMessage>,\n): string | undefined {\n  switch (message.role) {\n    case \"user\":\n      return `[user] ${contentText(message.content, \"\\n\")}`;\n    case \"assistant\": {\n      const parts = message.content.flatMap((part) => {\n        if (part.type === \"text\") return [part.text];\n        if (part.type !== \"toolCall\" || part.name === HISTORY_TOOL) return [];\n        const call = `→ ${part.name} ${JSON.stringify(part.arguments)}`;\n        const result = results.get(part.id);\n        return [result ? `${call}\\n← ${toolResultText(result)}` : call];\n      });\n      return parts.length > 0 ? `[assistant] ${parts.join(\"\\n\")}` : undefined;\n    }\n    case \"toolResult\":\n      return message.toolName === HISTORY_TOOL ? undefined : toolResultText(message);\n    default:\n      return undefined;\n  }\n}\n\nfunction historyEntries(entries: readonly SessionEntry[]): HistoryEntry[] {\n  const calls = new Set<string>();\n  const results = new Map<string, ToolResultMessage>();\n  for (const entry of entries) {\n    if (entry.type !== \"message\") continue;\n    if (entry.message.role === \"toolResult\") results.set(entry.message.toolCallId, entry.message);\n    if (entry.message.role !== \"assistant\") continue;\n    for (const part of entry.message.content) if (part.type === \"toolCall\") calls.add(part.id);\n  }\n  return entries.flatMap((entry) => {\n    switch (entry.type) {\n      case \"message\": {\n        const { message } = entry;\n        if (message.role === \"toolResult\" && calls.has(message.toolCallId)) return [];\n        const text = messageText(message, results);\n        return text ? [{ record: recordOf(entry.id), timestamp: entry.timestamp, text }] : [];\n      }\n      case \"compaction\":\n        return [\n          {\n            record: recordOf(entry.id),\n            timestamp: entry.timestamp,\n            text: `[summary] ${entry.summary}`,\n          },\n        ];\n      case \"custom\":\n        return [];\n    }\n  });\n}\n\nconst CJK_CHARACTER = /[\\u3040-\\u30ff\\u3400-\\u9fff\\uac00-\\ud7af]/;\n\nfunction wordMatches(text: string, word: string): boolean {\n  if (text.includes(word)) return true;\n  const characters = Array.from(word);\n  if (characters.length < 3 || !CJK_CHARACTER.test(word)) return false;\n  const pairs = characters.slice(1).map((character, index) => `${characters[index]}${character}`);\n  return pairs.filter((pair) => text.includes(pair)).length * 2 >= pairs.length;\n}\n\nfunction matches(text: string, query: string | undefined): boolean {\n  if (!query) return true;\n  const lower = text.toLowerCase();\n  return query.split(/\\s+/).every((word) => wordMatches(lower, word));\n}\n\nfunction entryLine(entry: HistoryEntry): string {\n  return `(${formatTime(entry.timestamp)}) ${clip(entry.text)}`;\n}\n\nfunction newestPage<T>(items: readonly T[], args: HistoryArgs): T[] {\n  const end = Math.max(items.length - (args.skip ?? 0), 0);\n  return items.slice(Math.max(end - (args.limit ?? DEFAULT_LIMIT), 0), end);\n}\n\nfunction bounded(header: string, lines: readonly string[], skip: number): string {\n  const kept: string[] = [];\n  let length = header.length;\n  for (const line of lines.toReversed()) {\n    if (length + line.length > MAX_OUTPUT_CHARS) break;\n    kept.unshift(line);\n    length += line.length;\n  }\n  const dropped = lines.length - kept.length;\n  const note =\n    dropped > 0\n      ? [`(${dropped} older results omitted by the output limit; use skip=${skip + kept.length})`]\n      : [];\n  return [header, ...note, ...kept].join(\"\\n\\n\");\n}\n\nfunction sessionKind(info: SessionListing): string {\n  if (info.root) return \"main, current\";\n  return isEarlierSessionKey(info.key) ? \"earlier session\" : \"thread\";\n}\n\nfunction sessionLabel(info: SessionListing, titles: ReadonlyMap<string, string>): string {\n  const suffix = isThreadSessionKey(info.key) ? threadSuffixOf(info.key) : undefined;\n  const title = suffix ? titles.get(suffix) : undefined;\n  const parent = info.parentSessionId\n    ? ` parent=${info.parentSessionId.slice(0, SESSION_REF_MIN_CHARS)}`\n    : \"\";\n  return `${info.id} (${sessionKind(info)}, ${formatTime(info.createdAt)}${parent})${title ? ` ${clip(title, 120)}` : \"\"}`;\n}\n\nfunction scopeTitles(office: Office): Map<string, string> {\n  const titles = new Map<string, string>();\n  for (const { message } of readConversationLog(office)) {\n    const firstLine = message.text\n      ?.split(\"\\n\")\n      .find((line) => line.trim())\n      ?.trim();\n    if (message.ts && firstLine) {\n      titles.set(message.ts, `[${message.userName ?? message.user ?? \"unknown\"}]: ${firstLine}`);\n    }\n  }\n  return titles;\n}\n\nfunction resolveSession(\n  sessions: readonly SessionListing[],\n  scope: HistoryScope,\n  ref: string,\n): SessionListing | string {\n  if (ref === \"current\") {\n    return (\n      sessions.find((info) => isScopeSession(info, scope)) ??\n      \"The current session has not started yet.\"\n    );\n  }\n  if (ref.length < SESSION_REF_MIN_CHARS) {\n    return `Use at least ${SESSION_REF_MIN_CHARS} characters of a session id.`;\n  }\n  const found = sessions.filter((info) => info.id.startsWith(ref));\n  const [only] = found;\n  if (found.length === 1 && only) return only;\n  return found.length === 0\n    ? `No session in this conversation starts with \"${ref}\". Use the sessions action to list them.`\n    : `\"${ref}\" matches ${found.length} sessions; use more characters.`;\n}\n\nasync function listSessions(scope: HistoryScope, args: HistoryArgs): Promise<string> {\n  const sessions = await listOfficeSessions(scope.office);\n  if (sessions.length === 0) return \"This conversation has no sessions yet.\";\n  const titles = scopeTitles(scope.office);\n  const lines = sessions\n    .map((info) => `${isScopeSession(info, scope) ? \"* \" : \"\"}${sessionLabel(info, titles)}`)\n    .toReversed();\n  return bounded(\n    `${sessions.length} sessions in this conversation, oldest first; * marks this one.`,\n    newestPage(lines, { ...args, limit: args.limit ?? MAX_LIMIT }),\n    args.skip ?? 0,\n  );\n}\n\nasync function sessionEntries(office: Office, info: SessionListing): Promise<HistoryEntry[]> {\n  const inspection = await SessionStore.inspect(office, info.key);\n  return inspection ? historyEntries(await inspection.getEntries()) : [];\n}\n\nasync function readSession(scope: HistoryScope, args: HistoryArgs): Promise<string> {\n  const sessions = await listOfficeSessions(scope.office);\n  const info = resolveSession(sessions, scope, args.session ?? \"current\");\n  if (typeof info === \"string\") return info;\n  const query = args.query?.trim().toLowerCase();\n  const found = (await sessionEntries(scope.office, info)).filter((entry) =>\n    matches(entry.text, query),\n  );\n  if (found.length === 0) {\n    return query ? `No entries match \"${args.query}\".` : \"The session is empty.\";\n  }\n  const page = newestPage(found, args);\n  return bounded(\n    `Session ${sessionLabel(info, scopeTitles(scope.office))}: ${found.length} entries; ${page.length} newest shown, oldest first.`,\n    page.map(entryLine),\n    args.skip ?? 0,\n  );\n}\n\nasync function searchSessions(scope: HistoryScope, args: HistoryArgs): Promise<string> {\n  const query = args.query?.trim().toLowerCase();\n  if (!query) return \"search needs a query; use read to page through a session.\";\n  const sessions = await listOfficeSessions(scope.office);\n  const selected = args.session ? resolveSession(sessions, scope, args.session) : undefined;\n  if (typeof selected === \"string\") return selected;\n  const titles = scopeTitles(scope.office);\n  const results: Array<HistoryEntry & { session: SessionListing }> = [];\n  const seen = new Set<string>();\n  for (const info of selected ? [selected] : sessions.toReversed()) {\n    for (const entry of await sessionEntries(scope.office, info)) {\n      if (seen.has(entry.record)) continue;\n      seen.add(entry.record);\n      if (matches(entry.text, query)) results.push({ ...entry, session: info });\n    }\n  }\n  if (results.length === 0) return `No session entries match \"${args.query}\".`;\n  const page = newestPage(\n    results.toSorted((a, b) => a.timestamp - b.timestamp),\n    args,\n  );\n  const lines = page.map((result, index) => {\n    const line = entryLine(result);\n    return page[index - 1]?.session === result.session\n      ? line\n      : `## session ${sessionLabel(result.session, titles)}\\n${line}`;\n  });\n  const sessionCount = new Set(results.map((result) => result.session)).size;\n  return bounded(\n    `${results.length} matching entries in ${sessionCount} sessions; ${page.length} newest shown, oldest first, grouped by session.`,\n    lines,\n    args.skip ?? 0,\n  );\n}\n\nfunction searchChat(scope: HistoryScope, args: HistoryArgs): string {\n  const query = args.query?.trim().toLowerCase();\n  const lines = readConversationLog(scope.office)\n    .map(({ message }) =>\n      formatHistoryLine({\n        date: message.date ? new Date(message.date) : undefined,\n        userName: message.userName ?? message.user,\n        threadTs: message.threadTs,\n        text: message.text ?? \"\",\n      }),\n    )\n    .filter((line) => matches(line, query));\n  if (lines.length === 0) {\n    return query ? `No chat messages match \"${args.query}\".` : \"The chat log is empty.\";\n  }\n  const page = newestPage(lines, args);\n  return bounded(\n    `${lines.length} ${query ? \"matching \" : \"\"}chat messages; ${page.length} newest shown, oldest first.`,\n    page.map((line) => clip(line)),\n    args.skip ?? 0,\n  );\n}\n\nexport async function runHistory(scope: HistoryScope, args: HistoryArgs): Promise<string> {\n  switch (args.action) {\n    case \"sessions\":\n      return listSessions(scope, args);\n    case \"search\":\n      return searchSessions(scope, args);\n    case \"read\":\n      return readSession(scope, args);\n    case \"chat\":\n      return searchChat(scope, args);\n  }\n}\n\nexport function createHistoryTool(scope: HistoryScope): AgentTool<typeof historySchema> {\n  return {\n    name: HISTORY_TOOL,\n    label: HISTORY_TOOL,\n    description:\n      \"Look back through this conversation's history beyond your context: its sessions (the channel or DM session, earlier ones replaced by /new, and its threads), their messages, your tool calls and their output, and the chat log. Read an earlier result here instead of rerunning its command. Other conversations are not reachable.\",\n    parameters: historySchema,\n    execute: async (_toolCallId, { label: _label, ...args }, signal) => {\n      signal?.throwIfAborted();\n      return {\n        content: [{ type: \"text\", text: await runHistory(scope, args) }],\n        details: undefined,\n      };\n    },\n  };\n}\n"]}

package/dist/harness/tools/host-fn-tool.d.ts

@@ -0,0 +1,14 @@
+import type { AgentTool } from "@earendil-works/pi-agent-core";
+import { Type, type Static, type TObject } from "typebox";
+export declare const LABEL_PARAMETER: Type.TString;
+export declare function defineHostFnTool<TFn, TParams extends TObject>(definition: {
+    name: string;
+    description: string;
+    parameters: TParams;
+    unavailable: string;
+    run: (fn: TFn, args: Static<TParams>, signal?: AbortSignal) => ReturnType<AgentTool<TParams>["execute"]>;
+}): {
+    tool: AgentTool<TParams>;
+    setFn: (fn: TFn | null) => void;
+};
+//# sourceMappingURL=host-fn-tool.d.ts.map

package/dist/harness/tools/host-fn-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-fn-tool.d.ts","sourceRoot":"","sources":["../../../src/harness/tools/host-fn-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,KAAK,MAAM,EAAE,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAE1D,eAAO,MAAM,eAAe,cAE1B,CAAC;AAEH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,SAAS,OAAO,EAAE,UAAU,EAAE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,CACH,EAAE,EAAE,GAAG,EACP,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,EACrB,MAAM,CAAC,EAAE,WAAW,KACjB,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;CAChD,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAAC,KAAK,EAAE,CAAC,EAAE,EAAE,GAAG,GAAG,IAAI,KAAK,IAAI,CAAA;CAAE,CAmChE"}

package/dist/harness/tools/host-fn-tool.js

@@ -0,0 +1,39 @@
+import { Type } from "typebox";
+export const LABEL_PARAMETER = Type.String({
+    description: "Brief description of this action (shown to user)",
+});
+export function defineHostFnTool(definition) {
+    let bound = null;
+    const schema = definition.parameters;
+    const parameters = {
+        ...schema,
+        properties: {
+            label: LABEL_PARAMETER,
+            ...schema.properties,
+        },
+        required: ["label", ...(schema.required ?? [])],
+    };
+    const tool = {
+        name: definition.name,
+        label: definition.name,
+        description: definition.description,
+        parameters,
+        execute: async (_toolCallId, args, signal) => {
+            if (!bound) {
+                throw new Error(definition.unavailable);
+            }
+            if (signal?.aborted) {
+                throw new Error("Operation aborted");
+            }
+            const { label: _label, ...rest } = args;
+            return definition.run(bound, rest, signal);
+        },
+    };
+    return {
+        tool,
+        setFn: (fn) => {
+            bound = fn;
+        },
+    };
+}
+//# sourceMappingURL=host-fn-tool.js.map

package/dist/harness/tools/host-fn-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-fn-tool.js","sourceRoot":"","sources":["../../../src/harness/tools/host-fn-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAA6B,MAAM,SAAS,CAAC;AAE1D,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC;IACzC,WAAW,EAAE,kDAAkD;CAChE,CAAC,CAAC;AAEH,MAAM,UAAU,gBAAgB,CAA+B,UAU9D;IACC,IAAI,KAAK,GAAe,IAAI,CAAC;IAC7B,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC;IACrC,MAAM,UAAU,GAAG;QACjB,GAAG,MAAM;QACT,UAAU,EAAE;YACV,KAAK,EAAE,eAAe;YACtB,GAAG,MAAM,CAAC,UAAU;SACrB;QACD,QAAQ,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;KACrC,CAAC;IAEb,MAAM,IAAI,GAAuB;QAC/B,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,KAAK,EAAE,UAAU,CAAC,IAAI;QACtB,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,UAAU;QACV,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;YAC3C,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;YAC1C,CAAC;YACD,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;YACvC,CAAC;YACD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,IAA+B,CAAC;YACnE,OAAO,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,IAAuB,EAAE,MAAM,CAAC,CAAC;QAChE,CAAC;KACF,CAAC;IAEF,OAAO;QACL,IAAI;QACJ,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE;YACZ,KAAK,GAAG,EAAE,CAAC;QACb,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { AgentTool } from \"@earendil-works/pi-agent-core\";\nimport { Type, type Static, type TObject } from \"typebox\";\n\nexport const LABEL_PARAMETER = Type.String({\n  description: \"Brief description of this action (shown to user)\",\n});\n\nexport function defineHostFnTool<TFn, TParams extends TObject>(definition: {\n  name: string;\n  description: string;\n  parameters: TParams;\n  unavailable: string;\n  run: (\n    fn: TFn,\n    args: Static<TParams>,\n    signal?: AbortSignal,\n  ) => ReturnType<AgentTool<TParams>[\"execute\"]>;\n}): { tool: AgentTool<TParams>; setFn: (fn: TFn | null) => void } {\n  let bound: TFn | null = null;\n  const schema = definition.parameters;\n  const parameters = {\n    ...schema,\n    properties: {\n      label: LABEL_PARAMETER,\n      ...schema.properties,\n    },\n    required: [\"label\", ...(schema.required ?? [])],\n  } as TParams;\n\n  const tool: AgentTool<TParams> = {\n    name: definition.name,\n    label: definition.name,\n    description: definition.description,\n    parameters,\n    execute: async (_toolCallId, args, signal) => {\n      if (!bound) {\n        throw new Error(definition.unavailable);\n      }\n      if (signal?.aborted) {\n        throw new Error(\"Operation aborted\");\n      }\n      const { label: _label, ...rest } = args as Record<string, unknown>;\n      return definition.run(bound, rest as Static<TParams>, signal);\n    },\n  };\n\n  return {\n    tool,\n    setFn: (fn) => {\n      bound = fn;\n    },\n  };\n}\n"]}

package/dist/harness/tools/index.d.ts

@@ -0,0 +1,34 @@
+import type { Api, Model } from "@earendil-works/pi-ai";
+import type { ConversationKind } from "../../types.js";
+import type { Executor, SandboxConfig } from "../../sandbox/types.js";
+import type { OfficeAddress, SandboxResourceController } from "../../types.js";
+import type { EventStore } from "../../events/index.js";
+import { type MikanHarnessTool } from "./pi-tools.js";
+import { createTaskTools } from "./task.js";
+import type { PlatformToolPack, PlatformToolRunContext } from "./types.js";
+export declare function createMikanTools(executor: Executor, eventStore: EventStore, sandboxController?: {
+    sandbox: SandboxConfig;
+    resourceController?: Pick<SandboxResourceController, "getLimitStatus" | "setLimits">;
+}, platformToolPacks?: readonly PlatformToolPack[], imageGeneration?: {
+    model: Model<Api>;
+    getApiKey: () => Promise<string | undefined>;
+    outputDir: string;
+}): {
+    tools: MikanHarnessTool[];
+    setUploadFunction: (fn: (filePath: string, title?: string) => Promise<void>) => void;
+    setImageUploadFunction: (fn: (hostPath: string, title?: string) => Promise<void>) => void;
+    bindTasks: ReturnType<typeof createTaskTools>["bindTasks"];
+    setReactFunction: (fn: ((emoji: string) => Promise<void>) | null) => void;
+    bindPlatformToolPacks: (ctx: PlatformToolRunContext) => void;
+    setEventContext: (context: {
+        platform: string;
+        conversationId: string;
+        conversationKind: ConversationKind;
+        userId: string;
+    }) => void;
+    setSandboxContext: (context: {
+        address: OfficeAddress;
+        userId: string;
+    }) => void;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/harness/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/harness/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EAAsC,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAE1F,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAK5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAE3E,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,UAAU,EACtB,iBAAiB,CAAC,EAAE;IAClB,OAAO,EAAE,aAAa,CAAC;IACvB,kBAAkB,CAAC,EAAE,IAAI,CAAC,yBAAyB,EAAE,gBAAgB,GAAG,WAAW,CAAC,CAAC;CACtF,EACD,iBAAiB,GAAE,SAAS,gBAAgB,EAAO,EACnD,eAAe,CAAC,EAAE;IAChB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAClB,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC7C,SAAS,EAAE,MAAM,CAAC;CACnB,GACA;IACD,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,iBAAiB,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IACrF,sBAAsB,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IAC1F,SAAS,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,WAAW,CAAC,CAAC;IAC3D,gBAAgB,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC;IAC1E,qBAAqB,EAAE,CAAC,GAAG,EAAE,sBAAsB,KAAK,IAAI,CAAC;IAC7D,eAAe,EAAE,CAAC,OAAO,EAAE;QACzB,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;QACvB,gBAAgB,EAAE,gBAAgB,CAAC;QACnC,MAAM,EAAE,MAAM,CAAC;KAChB,KAAK,IAAI,CAAC;IACX,iBAAiB,EAAE,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,aAAa,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAClF,CAuCA"}

package/dist/harness/tools/index.js

@@ -0,0 +1,49 @@
+import { createAttachTool } from "./attach.js";
+import { createEventTool } from "./event.js";
+import { createGenerateImageTool } from "./generate-image.js";
+import { adaptAgentTool, createSandboxTools } from "./pi-tools.js";
+import { withSecretRedaction } from "./secret-redaction.js";
+import { createTaskTools } from "./task.js";
+import { createJevTool } from "./jev.js";
+import { createJevBrowserTool } from "./jev-browser.js";
+import { createReactTool } from "./react.js";
+import { createSandboxTool } from "./sandbox.js";
+export function createMikanTools(executor, eventStore, sandboxController, platformToolPacks = [], imageGeneration) {
+    const { tool: attachTool, setUploadFunction } = createAttachTool();
+    const imageTool = imageGeneration ? createGenerateImageTool(imageGeneration) : undefined;
+    const { tools: taskTools, bindTasks } = createTaskTools();
+    const { tool: reactTool, setReactFunction } = createReactTool();
+    const jevTool = createJevTool();
+    const jevBrowserTool = createJevBrowserTool(executor);
+    const { tool: eventTool, setEventContext } = createEventTool(eventStore);
+    const { tool: sandboxTool, setSandboxContext } = createSandboxTool(sandboxController ?? { sandbox: executor.getSandboxConfig() });
+    const packTools = platformToolPacks.flatMap((pack) => pack.tools);
+    return {
+        tools: [
+            ...createSandboxTools(),
+            adaptAgentTool(eventTool),
+            adaptAgentTool(sandboxTool),
+            adaptAgentTool(attachTool),
+            ...(imageTool ? [adaptAgentTool(imageTool.tool)] : []),
+            adaptAgentTool(reactTool),
+            adaptAgentTool(jevTool),
+            adaptAgentTool(jevBrowserTool),
+            ...taskTools.map(adaptAgentTool),
+            ...packTools.map(adaptAgentTool),
+        ].map(withSecretRedaction),
+        setUploadFunction,
+        setImageUploadFunction: (fn) => {
+            imageTool?.setUploadFunction(fn);
+        },
+        setReactFunction,
+        bindTasks,
+        bindPlatformToolPacks: (ctx) => {
+            for (const pack of platformToolPacks) {
+                pack.bindRun(ctx);
+            }
+        },
+        setEventContext,
+        setSandboxContext,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/harness/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/harness/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAI/C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAyB,MAAM,eAAe,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGjD,MAAM,UAAU,gBAAgB,CAC9B,QAAkB,EAClB,UAAsB,EACtB,iBAGC,EACD,iBAAiB,GAAgC,EAAE,EACnD,eAIC;IAgBD,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,iBAAiB,EAAE,GAAG,gBAAgB,EAAE,CAAC;IACnE,MAAM,SAAS,GAAG,eAAe,CAAC,CAAC,CAAC,uBAAuB,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACzF,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,eAAe,EAAE,CAAC;IAC1D,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,gBAAgB,EAAE,GAAG,eAAe,EAAE,CAAC;IAChE,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,MAAM,cAAc,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACtD,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,eAAe,EAAE,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IACzE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,CAChE,iBAAiB,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,gBAAgB,EAAE,EAAE,CAC9D,CAAC;IACF,MAAM,SAAS,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClE,OAAO;QACL,KAAK,EAAE;YACL,GAAG,kBAAkB,EAAE;YACvB,cAAc,CAAC,SAAS,CAAC;YACzB,cAAc,CAAC,WAAW,CAAC;YAC3B,cAAc,CAAC,UAAU,CAAC;YAC1B,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,cAAc,CAAC,SAAS,CAAC;YACzB,cAAc,CAAC,OAAO,CAAC;YACvB,cAAc,CAAC,cAAc,CAAC;YAC9B,GAAG,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC;YAChC,GAAG,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC;SACjC,CAAC,GAAG,CAAC,mBAAmB,CAAC;QAC1B,iBAAiB;QACjB,sBAAsB,EAAE,CAAC,EAAE,EAAE,EAAE;YAC7B,SAAS,EAAE,iBAAiB,CAAC,EAAE,CAAC,CAAC;QACnC,CAAC;QACD,gBAAgB;QAChB,SAAS;QACT,qBAAqB,EAAE,CAAC,GAAG,EAAE,EAAE;YAC7B,KAAK,MAAM,IAAI,IAAI,iBAAiB,EAAE,CAAC;gBACrC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;QACD,eAAe;QACf,iBAAiB;KAClB,CAAC;AACJ,CAAC","sourcesContent":["import type { Api, Model } from \"@earendil-works/pi-ai\";\nimport type { ConversationKind } from \"../../types.js\";\nimport { createAttachTool } from \"./attach.js\";\nimport type { Executor, SandboxConfig } from \"../../sandbox/types.js\";\nimport type { OfficeAddress, SandboxResourceController } from \"../../types.js\";\nimport type { EventStore } from \"../../events/index.js\";\nimport { createEventTool } from \"./event.js\";\nimport { createGenerateImageTool } from \"./generate-image.js\";\nimport { adaptAgentTool, createSandboxTools, type MikanHarnessTool } from \"./pi-tools.js\";\nimport { withSecretRedaction } from \"./secret-redaction.js\";\nimport { createTaskTools } from \"./task.js\";\nimport { createJevTool } from \"./jev.js\";\nimport { createJevBrowserTool } from \"./jev-browser.js\";\nimport { createReactTool } from \"./react.js\";\nimport { createSandboxTool } from \"./sandbox.js\";\nimport type { PlatformToolPack, PlatformToolRunContext } from \"./types.js\";\n\nexport function createMikanTools(\n  executor: Executor,\n  eventStore: EventStore,\n  sandboxController?: {\n    sandbox: SandboxConfig;\n    resourceController?: Pick<SandboxResourceController, \"getLimitStatus\" | \"setLimits\">;\n  },\n  platformToolPacks: readonly PlatformToolPack[] = [],\n  imageGeneration?: {\n    model: Model<Api>;\n    getApiKey: () => Promise<string | undefined>;\n    outputDir: string;\n  },\n): {\n  tools: MikanHarnessTool[];\n  setUploadFunction: (fn: (filePath: string, title?: string) => Promise<void>) => void;\n  setImageUploadFunction: (fn: (hostPath: string, title?: string) => Promise<void>) => void;\n  bindTasks: ReturnType<typeof createTaskTools>[\"bindTasks\"];\n  setReactFunction: (fn: ((emoji: string) => Promise<void>) | null) => void;\n  bindPlatformToolPacks: (ctx: PlatformToolRunContext) => void;\n  setEventContext: (context: {\n    platform: string;\n    conversationId: string;\n    conversationKind: ConversationKind;\n    userId: string;\n  }) => void;\n  setSandboxContext: (context: { address: OfficeAddress; userId: string }) => void;\n} {\n  const { tool: attachTool, setUploadFunction } = createAttachTool();\n  const imageTool = imageGeneration ? createGenerateImageTool(imageGeneration) : undefined;\n  const { tools: taskTools, bindTasks } = createTaskTools();\n  const { tool: reactTool, setReactFunction } = createReactTool();\n  const jevTool = createJevTool();\n  const jevBrowserTool = createJevBrowserTool(executor);\n  const { tool: eventTool, setEventContext } = createEventTool(eventStore);\n  const { tool: sandboxTool, setSandboxContext } = createSandboxTool(\n    sandboxController ?? { sandbox: executor.getSandboxConfig() },\n  );\n  const packTools = platformToolPacks.flatMap((pack) => pack.tools);\n  return {\n    tools: [\n      ...createSandboxTools(),\n      adaptAgentTool(eventTool),\n      adaptAgentTool(sandboxTool),\n      adaptAgentTool(attachTool),\n      ...(imageTool ? [adaptAgentTool(imageTool.tool)] : []),\n      adaptAgentTool(reactTool),\n      adaptAgentTool(jevTool),\n      adaptAgentTool(jevBrowserTool),\n      ...taskTools.map(adaptAgentTool),\n      ...packTools.map(adaptAgentTool),\n    ].map(withSecretRedaction),\n    setUploadFunction,\n    setImageUploadFunction: (fn) => {\n      imageTool?.setUploadFunction(fn);\n    },\n    setReactFunction,\n    bindTasks,\n    bindPlatformToolPacks: (ctx) => {\n      for (const pack of platformToolPacks) {\n        pack.bindRun(ctx);\n      }\n    },\n    setEventContext,\n    setSandboxContext,\n  };\n}\n"]}

package/dist/harness/tools/jev-browser.d.ts

@@ -0,0 +1,41 @@
+import type { AgentTool } from "@earendil-works/pi-agent-core";
+import { Type } from "typebox";
+import type { Executor } from "../../sandbox/types.js";
+import { type JevQuestions } from "../jev.js";
+export declare const JEV_BROWSER_TOOL = "jev_browser";
+declare const jevBrowserSchema: Type.TObject<{
+    label: Type.TString;
+    goal: Type.TOptional<Type.TString>;
+    url: Type.TOptional<Type.TString>;
+    frame: Type.TOptional<Type.TString>;
+    commands: Type.TOptional<Type.TArray<Type.TArray<Type.TString>>>;
+    close: Type.TOptional<Type.TBoolean>;
+    maxSteps: Type.TOptional<Type.TInteger>;
+}>;
+interface RefInfo {
+    role: string;
+    name: string;
+}
+interface BrowserLifecycle {
+    reused?: boolean;
+    relaunchedBrowser?: boolean;
+    launched?: boolean;
+}
+declare function describeContinuity(expectedOpen: boolean, first: BrowserLifecycle | undefined): string;
+declare function truncate(text: string, max: number): string;
+declare function categorizeRefs(refs: Record<string, RefInfo>): {
+    click: [string, RefInfo][];
+    type: [string, RefInfo][];
+    select: [string, RefInfo][];
+};
+interface QuestionPlan {
+    questions: JevQuestions;
+    singles: Record<string, string>;
+}
+declare function buildQuestionPlan(refs: Record<string, RefInfo>, canScrollUp: boolean, canScrollDown: boolean, snapshot?: string): QuestionPlan;
+declare function resolveTarget(operation: string, answers: Record<string, {
+    choice?: unknown;
+} | undefined>, singles: Record<string, string>): string | undefined;
+export declare function createJevBrowserTool(executor: Executor): AgentTool<typeof jevBrowserSchema>;
+export { buildQuestionPlan, resolveTarget, categorizeRefs, truncate, describeContinuity };
+//# sourceMappingURL=jev-browser.d.ts.map

package/dist/harness/tools/jev-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jev-browser.d.ts","sourceRoot":"","sources":["../../../src/harness/tools/jev-browser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAe,MAAM,SAAS,CAAC;AAE5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGvD,OAAO,EAAkC,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAK9E,eAAO,MAAM,gBAAgB,gBAAgB,CAAC;AAsB9C,QAAA,MAAM,gBAAgB;;;;;;;;EAuCpB,CAAC;AAIH,UAAU,OAAO;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAcD,UAAU,gBAAgB;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAMD,iBAAS,kBAAkB,CAAC,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,GAAG,SAAS,GAAG,MAAM,CAY9F;AA4ED,iBAAS,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAuCD,iBAAS,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACtD,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAC3B,IAAI,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAC1B,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CAC7B,CAOA;AAmBD,UAAU,YAAY;IACpB,SAAS,EAAE,YAAY,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,iBAAS,iBAAiB,CACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,WAAW,EAAE,OAAO,EACpB,aAAa,EAAE,OAAO,EACtB,QAAQ,SAAK,GACZ,YAAY,CAiDd;AAwDD,iBAAS,aAAa,CACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CAAC,EACzD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,MAAM,GAAG,SAAS,CAUpB;AA6WD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC,OAAO,gBAAgB,CAAC,CAqB3F;AAED,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAC"}