tryharness 0.7.28 → 0.7.29

package/lib/snippets.mjs

@@ -4,10 +4,12 @@ import { randomUUID } from "node:crypto";
 import { nameOf } from "./members.mjs";
 import { repositoryOf } from "./worktrees.mjs";
 
-// Code for an agent that does not run on this computer (Grok Bot, Muse) leaves it only with the person's OK. The agent
-// says what it needs to see (request_snippet); the relay finds it in the thread's folder with its local search, takes
-// the lines around it, masks any secret in them, and holds them. The person shares or keeps them (the buddy, or
-// `tryharness board snippet <id> share|keep`); shared lines are posted in the thread for that agent, kept ones never leave.
+// Code or a file for an agent that does not run on this computer (Grok Bot, Muse) leaves it only with the person's OK.
+// The agent says what it needs to see (request_snippet); the relay finds it with its local search, in the thread's
+// folder (code) or in the folders the person added to the library (files), masks any secret in it, and holds it. The
+// person shares or keeps it (the buddy, or `tryharness board snippet <id> share|keep`); what is shared is posted in the
+// thread for that agent, what is kept never leaves. A file's part goes as its words (a page, a passage), a picture with
+// keys and personal details covered, or what a recording's minute says.
 
 const BEFORE = 5;
 const LINES = 40;
@@ -16,6 +18,7 @@ export function createSnippets({
   store,
   search,
   scrub,
+  files = null,
   wake = () => {},
   notify = () => {},
   log = () => {},
@@ -35,9 +38,12 @@ export function createSnippets({
   };
 
   /** A cloud agent's request: { ok, snippet } held for the person, or why there is nothing to hold. */
-  const request = async ({ threadId, agent, about }) => {
+  const request = async ({ threadId, agent, about, where = null }) => {
     const thread = store.getTask(threadId);
     const folder = thread?.kind === "goal" ? thread.goal.workspace : null;
+    // Without a say, a thread with a folder means its code, one without means the person's files.
+    if ((where ?? (folder ? "code" : "files")) === "files")
+      return requestFile({ threadId, agent, about });
     if (!folder)
       return {
         ok: false,
@@ -100,6 +106,107 @@ export function createSnippets({
     };
   };
 
+  /** The part of a file the agent asked about, prepared to leave: { text } or { picture }, and what was hidden. */
+  const prepare = async (content) => {
+    if (content.modality === "text") return scrub(content.text);
+    if (content.modality === "audio") {
+      const heard = await files.transcribe(content);
+      return heard
+        ? scrub(heard)
+        : { error: "nothing could be heard in that minute" };
+    }
+    const covered = await files.cover(content.data);
+    if (covered.refused) return { error: covered.refused };
+    return {
+      picture: files.keep(covered.bytes),
+      mime: covered.mime,
+      masked: covered.masked?.length ?? 0,
+    };
+  };
+
+  const requestFile = async ({ threadId, agent, about }) => {
+    if (!files)
+      return { ok: false, error: "the person's files are not searchable here" };
+    const words = String(about || "")
+      .trim()
+      .slice(0, 500);
+    if (!words) return { ok: false, error: "say what you need to see" };
+    const [hit] = await files.search(words);
+    if (!hit)
+      return {
+        ok: false,
+        error: "nothing in the folders the person added matched that",
+      };
+    let ready = null;
+    try {
+      const content = await files.content(hit.file, hit.vec);
+      ready = content ? await prepare(content) : null;
+    } catch (error) {
+      ready = { error: error.message };
+    }
+    if (!ready || ready.error)
+      return {
+        ok: false,
+        error: ready?.error || `${hit.name} could not be read`,
+      };
+    const label = hit.place ? `${hit.place} of ${hit.name}` : hit.name;
+    const snippet = {
+      id: randomUUID(),
+      thread: threadId,
+      agent,
+      about: words,
+      source: "files",
+      label,
+      path: hit.file,
+      text:
+        ready.text ??
+        `A picture: ${label}, with keys and personal details covered.`,
+      picture: ready.picture ?? null,
+      mime: ready.mime ?? null,
+      masked: ready.masked,
+      state: "waiting",
+      at: new Date().toISOString(),
+    };
+    save(snippet);
+    store.roomPost({
+      goalId: threadId,
+      author: "harness",
+      kind: "note",
+      text: `${nameOf(agent)} asks to see ${label} from your files ("${words.slice(0, 120)}"). It stays on this computer until you share it.`,
+    });
+    notify(
+      `${nameOf(agent)} asks to see ${label}. Share or keep it in Harness.`,
+      snippet
+    );
+    return {
+      ok: true,
+      snippet: { id: snippet.id, label, state: "waiting" },
+      note: "The person decides whether to share it; you are told in the thread.",
+    };
+  };
+
+  /** What the thread is told when the person shares a waiting snippet. */
+  const sharedText = (snippet) => {
+    const hidden = snippet.masked
+      ? ` (${snippet.masked} secret${snippet.masked === 1 ? "" : "s"} in it stay masked)`
+      : "";
+    if (snippet.source !== "files")
+      return `@${snippet.agent} the person shared lines ${snippet.from} to ${snippet.to} of ${snippet.path}${hidden}:\n\n\`\`\`\n${snippet.text}\n\`\`\``;
+    if (snippet.picture) {
+      const file = files.attach({
+        threadId: snippet.thread,
+        sha256: snippet.picture,
+        mime: snippet.mime,
+        name: `${snippet.label}.${snippet.mime === "image/jpeg" ? "jpg" : "png"}`,
+      });
+      return `@${snippet.agent} the person shared ${snippet.label}, with keys and personal details covered: file ${file.id} (get_file opens it).`;
+    }
+    return `@${snippet.agent} the person shared ${snippet.label}${hidden}:\n\n${snippet.text
+      .split("\n")
+      .map((line) => `> ${line}`)
+      .join("\n")}`;
+  };
+
   /** The person shares or keeps a waiting snippet. */
   const decide = (id, share) => {
     const snippet = read(id);
@@ -118,7 +225,7 @@ export function createSnippets({
         author: "harness",
         kind: "post",
         mentions: [snippet.agent],
-        text: `@${snippet.agent} the person shared lines ${snippet.from} to ${snippet.to} of ${snippet.path}${snippet.masked ? ` (${snippet.masked} secret${snippet.masked === 1 ? "" : "s"} in them stay masked)` : ""}:\n\n\`\`\`\n${snippet.text}\n\`\`\``,
+        text: sharedText(snippet),
       });
       wake(snippet.thread, post, [snippet.agent]);
     } else
@@ -126,7 +233,7 @@ export function createSnippets({
         goalId: snippet.thread,
         author: "harness",
         kind: "note",
-        text: `The person kept lines ${snippet.from} to ${snippet.to} of ${snippet.path} on this computer.`,
+        text: `The person kept ${snippet.label ?? `lines ${snippet.from} to ${snippet.to} of ${snippet.path}`} on this computer.`,
       });
     log(`snippet ${id}: ${done.state}`);
     return { ok: true, snippet: { id, state: done.state } };

package/lib/store.mjs

@@ -1670,6 +1670,12 @@ export function openStore(file) {
         String(id)
       );
     },
+    presentFiles() {
+      return execute(
+        "all",
+        "select id from board_files where present = 1 order by created_at asc"
+      ).map((row) => this.file(row.id));
+    },
     taskFiles(taskId) {
       return execute(
         "all",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tryharness",
-  "version": "0.7.28",
+  "version": "0.7.29",
   "description": "Harness Relay: the daemon that turns the agents on this machine into your personal swarm. Memory, history, and work handed between any of them.",
   "bin": {
     "tryharness": "cli.mjs"