@saadnvd1/agent-os 0.3.815 → 0.3.817

package/app/api/files/upload-temp/route.test.ts

@@ -68,7 +68,7 @@ describe("POST /api/files/upload-temp", () => {
   });
 
   it("refuses types it doesn't take, saying which", async () => {
-    for (const name of ["a.zip", "run.sh", "tool.exe", "noext"]) {
+    for (const name of ["a.zip", "tool.exe", "noext", "clip.mov"]) {
       const res = await upload(name, "x", { sessionId: SESSION });
       expect(res.status).toBe(415);
       expect((await res.json()).error).toContain(`${name}: this file type`);
@@ -105,11 +105,61 @@ describe("POST /api/files/upload-temp", () => {
 
   it("refuses a file over the limit, and says what the limit is", async () => {
     const big = Buffer.alloc(ATTACHMENT_LIMITS.maxBytes + 1, 97);
-    const res = await upload("big.txt", big, { sessionId: SESSION });
+    const res = await upload("big.csv", big, { sessionId: SESSION });
     expect(res.status).toBe(413);
     expect((await res.json()).error).toContain("the limit is 25.0 MB");
   });
 
+  it("takes shell scripts, config and extensionless names as text", async () => {
+    for (const name of ["run.sh", "Dockerfile", ".env.example", "main.tf"]) {
+      const res = await upload(name, "echo hi\n", { sessionId: SESSION });
+      expect(res.status, name).toBe(200);
+      expect((await res.json()).kind).toBe("text");
+    }
+  });
+
+  it("names what is accepted when it refuses a type", async () => {
+    const res = await upload("a.zip", "x", { sessionId: SESSION });
+    expect((await res.json()).error).toMatch(/HAR.*HEIC|HEIC.*HAR/);
+  });
+
+  it("redacts a HAR on the way in and keeps a summary beside it", async () => {
+    const secret = ["s", "3", "cr", "et"].join("") + Date.now();
+    const har = JSON.stringify({
+      log: {
+        entries: [
+          {
+            request: {
+              method: "GET",
+              url: "https://api.example.com/me",
+              headers: [{ name: "Authorization", value: `Bearer ${secret}` }],
+              cookies: [{ name: "sid", value: secret }],
+            },
+            response: { status: 500, headers: [], cookies: [] },
+          },
+        ],
+      },
+    });
+    const res = await upload("trace.har", har, { sessionId: SESSION });
+    expect(res.status).toBe(200);
+    const body = await res.json();
+    expect(body.mediaType).toBe("application/json");
+    const saved = fs.readFileSync(body.path, "utf8");
+    expect(saved).not.toContain(secret);
+    expect(saved).toContain("api.example.com/me");
+    expect(fs.readFileSync(`${body.path}.summary.txt`, "utf8")).toContain(
+      "1 requests"
+    );
+  });
+
+  it("refuses a .har that isn't a HAR", async () => {
+    for (const data of ["not json", '{"log":{}}']) {
+      const res = await upload("x.har", data, { sessionId: SESSION });
+      expect(res.status).toBe(400);
+      expect((await res.json()).error).toContain("real HAR");
+    }
+  });
+
   it("refuses an image over the image limit", async () => {
     const big = Buffer.concat([
       PNG,
@@ -122,7 +172,9 @@ describe("POST /api/files/upload-temp", () => {
     const res = await POST(
       new Request("http://localhost/x", {
         method: "POST",
-        headers: { "content-length": String(ATTACHMENT_LIMITS.maxBytes * 2) },
+        headers: {
+          "content-length": String(ATTACHMENT_LIMITS.maxTextBytes * 2),
+        },
         body: "{}",
       })
     );

package/app/api/files/upload-temp/route.ts

@@ -4,11 +4,13 @@ import path from "path";
 import os from "os";
 import { checkUpload } from "@/lib/attachments/check";
 import { ATTACHMENT_LIMITS, tooBigMessage } from "@/lib/attachments/policy";
+import { prepareUpload } from "@/lib/attachments/prepare";
 import { saveAttachment } from "@/lib/attachments/store";
 import { peerChatLink } from "@/lib/chat/peer-relay";
 
 // Base64 is a third bigger than the bytes, and the JSON around it is small.
-const MAX_BODY = Math.ceil((ATTACHMENT_LIMITS.maxBytes * 4) / 3) + 64 * 1024;
+const MAX_BODY =
+  Math.ceil((ATTACHMENT_LIMITS.maxTextBytes * 4) / 3) + 64 * 1024;
 
 const fail = (error: string, status: number) =>
   NextResponse.json({ error }, { status });
@@ -34,6 +36,8 @@ export async function POST(request: Request) {
     const buffer = Buffer.from(base64, "base64");
     const checked = checkUpload(name, buffer);
     if (!checked.ok) return fail(checked.error, checked.status);
+    const prepared = await prepareUpload(checked.type, name, buffer);
+    if (!prepared.ok) return fail(prepared.error, prepared.status);
 
     if (typeof sessionId === "string" && sessionId) {
       if (sessionId !== "draft" && peerChatLink(sessionId))
@@ -43,25 +47,26 @@ export async function POST(request: Request) {
         );
       const file = saveAttachment(
         sessionId,
-        name,
-        buffer,
-        checked.type.mediaType
+        prepared.name,
+        prepared.data,
+        prepared.mediaType,
+        prepared.summary
       );
-      return NextResponse.json({ ...file, kind: checked.type.kind });
+      return NextResponse.json({ ...file, kind: prepared.kind });
     }
 
     const tempDir = path.join(os.tmpdir(), "agent-os-screenshots");
     await mkdir(tempDir, { recursive: true });
-    const safeName = name.replace(/[^a-zA-Z0-9.-]/g, "_");
+    const safeName = prepared.name.replace(/[^a-zA-Z0-9.-]/g, "_");
     const filePath = path.join(tempDir, `${Date.now()}-${safeName}`);
-    await writeFile(filePath, buffer);
+    await writeFile(filePath, prepared.data);
 
     return NextResponse.json({
       path: filePath,
       name: safeName,
-      size: buffer.length,
-      mediaType: checked.type.mediaType,
-      kind: checked.type.kind,
+      size: prepared.data.length,
+      mediaType: prepared.mediaType,
+      kind: prepared.kind,
     });
   } catch (error) {
     console.error("Upload error:", error);

package/components/Chat/FileChip.tsx

@@ -32,14 +32,18 @@ export function FileChip({
   uploading?: boolean;
   onRemove?: () => void;
 }) {
-  const Icon = ICONS[typeFor(file.name)?.kind ?? "text"];
+  const type = typeFor(file.name);
+  const Icon = ICONS[type?.kind ?? "text"];
+  const detail = uploading
+    ? "Uploading…"
+    : [formatBytes(file.size), type?.note].filter(Boolean).join(" · ");
   return (
     <div
       className={cn(
         "bg-foreground/[0.05] flex h-14 max-w-56 min-w-0 items-center gap-2 rounded-lg pl-3",
         onRemove ? "pr-1" : "pr-3"
       )}
-      title={file.name}
+      title={type?.note ? `${file.name} (${type.note})` : file.name}
     >
       {uploading ? (
         <Loader2 className="text-muted-foreground h-4 w-4 shrink-0 animate-spin" />
@@ -48,8 +52,8 @@ export function FileChip({
       )}
       <span className="min-w-0">
         <span className="block truncate text-sm">{file.name}</span>
-        <span className="text-muted-foreground block text-xs">
-          {uploading ? "Uploading…" : formatBytes(file.size)}
+        <span className="text-muted-foreground block truncate text-xs">
+          {detail}
         </span>
       </span>
       {onRemove && (

package/components/Chat/composer/paste.ts

@@ -14,9 +14,12 @@ export interface PasteHandlers {
 }
 
 // Dragged files sometimes arrive without a type; go by the name then.
+// Only the formats a model takes; HEIC photos and SVG go up as files, where
+// the server converts or keeps them.
+const INLINE_IMAGE = /^image\/(png|jpe?g|gif|webp)$/;
 export const isImage = (f: File) =>
-  f.type.startsWith("image/") ||
-  (!f.type && /\.(png|jpe?g|gif|webp|heic)$/i.test(f.name));
+  INLINE_IMAGE.test(f.type) ||
+  (!f.type && /\.(png|jpe?g|gif|webp)$/i.test(f.name));
 
 function editorMode(data: DataTransfer): string | undefined {
   try {

package/components/Chat/composer/useAttachFiles.ts

@@ -9,6 +9,7 @@ import {
 } from "@/data/client-config/queries";
 import {
   acceptAttr,
+  limitFor,
   tooBigMessage,
   typeFor,
   unsupportedMessage,
@@ -83,11 +84,13 @@ export function useAttachFiles({
         const shrunk = await shrinkImage(f, limits.maxImageBytes);
         if (shrunk.ok) images.push(shrunk.file);
         else error = tooBigMessage(f.name, f.size, limits.maxImageBytes);
-      } else if (!typeFor(f.name, limits.types))
-        error = unsupportedMessage(f.name);
-      else if (f.size > limits.maxBytes)
-        error = tooBigMessage(f.name, f.size, limits.maxBytes);
-      else others.push(f);
+      } else {
+        const type = typeFor(f.name, limits.types);
+        if (!type) error = unsupportedMessage(f.name);
+        else if (f.size > limitFor(type, limits))
+          error = tooBigMessage(f.name, f.size, limitFor(type, limits));
+        else others.push(f);
+      }
       if (error) toast.error(error);
     }
     if (images.length) onImages(await Promise.all(images.map(readImage)));

package/content/whats-new.json

@@ -1897,6 +1897,14 @@
       "area": "AgentOS",
       "text": "The reachability check now tells a stuck AgentOS apart from another program on its port, and setup keeps a copy of a startup file you edited before replacing it.",
       "url": "https://github.com/saadnvd1/agent-os/pull/547"
+    },
+    {
+      "id": 548,
+      "date": "2026-11-01",
+      "kind": "new",
+      "area": "Chat",
+      "text": "Chats now accept HAR network captures (with logins and cookies hidden), iPhone photos and many more file types.",
+      "url": "https://github.com/saadnvd1/agent-os/pull/548"
     }
   ]
 }

package/lib/attachments/check.ts

@@ -1,6 +1,6 @@
 import { isText, sniff } from "../intake/sniff";
 import {
-  ATTACHMENT_LIMITS,
+  limitFor,
   tooBigMessage,
   typeFor,
   unsupportedMessage,
@@ -28,10 +28,7 @@ const bad = (name: string): UploadCheck => ({
 export function checkUpload(name: string, data: Buffer): UploadCheck {
   const type = typeFor(name);
   if (!type) return { ok: false, status: 415, error: unsupportedMessage(name) };
-  const limit =
-    type.kind === "image"
-      ? ATTACHMENT_LIMITS.maxImageBytes
-      : ATTACHMENT_LIMITS.maxBytes;
+  const limit = limitFor(type);
   if (data.length > limit)
     return {
       ok: false,

package/lib/attachments/har.ts

@@ -0,0 +1,122 @@
+// A HAR is a browser's network log: it carries live cookies and bearer
+// tokens. On the way in the values of the credential headers and every
+// cookie are replaced; names, URLs, timings, bodies and statuses stay.
+
+export const REDACTED = "[redacted]";
+
+const SECRET_HEADER =
+  /^(cookie|set-cookie|authorization|proxy-authorization)$|api[-_]?key|token|secret|^x-(csrf|xsrf)/i;
+
+interface Pair {
+  name?: unknown;
+  value?: unknown;
+}
+
+interface Message {
+  headers?: Pair[];
+  cookies?: Pair[];
+  status?: number;
+  bodySize?: number;
+  content?: { size?: number };
+}
+
+interface Entry {
+  request?: Message & { method?: string; url?: string };
+  response?: Message;
+  time?: number;
+}
+
+export interface HarResult {
+  json: string;
+  redacted: number;
+  summary: string;
+}
+
+function scrub(list: Pair[] | undefined, always: boolean): number {
+  let n = 0;
+  if (!Array.isArray(list)) return n;
+  for (const p of list) {
+    if (!p || typeof p !== "object" || p.value === REDACTED) continue;
+    if (always || (typeof p.name === "string" && SECRET_HEADER.test(p.name))) {
+      p.value = REDACTED;
+      n++;
+    }
+  }
+  return n;
+}
+
+const hostOf = (url: string) => {
+  try {
+    return new URL(url).host;
+  } catch {
+    return "(unparsed)";
+  }
+};
+
+const top = (counts: Map<string, number>, n: number) =>
+  [...counts].sort((a, b) => b[1] - a[1]).slice(0, n);
+
+function summarize(entries: Entry[]): string {
+  const hosts = new Map<string, number>();
+  const statuses = new Map<string, number>();
+  const rows = entries.map((e) => {
+    const url = e.request?.url ?? "";
+    const status = e.response?.status ?? 0;
+    const host = hostOf(url);
+    hosts.set(host, (hosts.get(host) ?? 0) + 1);
+    const klass = status >= 100 ? `${Math.floor(status / 100)}xx` : "failed";
+    statuses.set(klass, (statuses.get(klass) ?? 0) + 1);
+    const size = Math.max(
+      e.response?.content?.size ?? 0,
+      e.response?.bodySize ?? 0
+    );
+    const line = `${e.request?.method ?? "?"} ${url.slice(0, 160)} -> ${status || "no response"}`;
+    return { line, size, status, time: e.time ?? 0 };
+  });
+  const failing = rows.filter((r) => r.status === 0 || r.status >= 400);
+  const largest = [...rows].sort((a, b) => b.size - a.size).slice(0, 5);
+  const lines = [
+    `HAR summary: ${entries.length} requests, ${hosts.size} hosts.`,
+    `Hosts: ${top(hosts, 8)
+      .map(([h, c]) => `${h} (${c})`)
+      .join(", ")}`,
+    `Status: ${[...statuses]
+      .sort()
+      .map(([k, c]) => `${k} ${c}`)
+      .join(", ")}`,
+    `Largest responses: ${largest.map((r) => `${r.line} [${r.size} B]`).join("; ")}`,
+    failing.length
+      ? `Failing (${failing.length}${failing.length > 8 ? ", first 8" : ""}): ${failing
+          .slice(0, 8)
+          .map((r) => r.line)
+          .join("; ")}`
+      : "Failing: none",
+    "Cookie and auth header values were replaced with [redacted].",
+  ];
+  return lines.join("\n");
+}
+
+/** The HAR with its secrets replaced and a short summary, or null when the text isn't a HAR. */
+export function redactHar(text: string): HarResult | null {
+  let har: { log?: { entries?: Entry[] } };
+  try {
+    har = JSON.parse(text);
+  } catch {
+    return null;
+  }
+  const entries = har?.log?.entries;
+  if (!Array.isArray(entries)) return null;
+  let redacted = 0;
+  for (const e of entries) {
+    for (const m of [e?.request, e?.response]) {
+      if (!m || typeof m !== "object") continue;
+      redacted += scrub(m.headers, false) + scrub(m.cookies, true);
+    }
+  }
+  // Indented, so the agent can grep and read it by line.
+  return {
+    json: JSON.stringify(har, null, 1),
+    redacted,
+    summary: summarize(entries.filter((e) => e && typeof e === "object")),
+  };
+}

package/lib/attachments/message.ts

@@ -1,5 +1,6 @@
 import fs from "fs";
 import { ATTACHMENT_LIMITS, formatBytes } from "./policy";
+import { summaryPath } from "./store";
 import type { ChatFile } from "./types";
 
 /**
@@ -8,14 +9,35 @@ import type { ChatFile } from "./types";
  * spreadsheet through a script, a docx through pandoc). The chat keeps the
  * plain text and shows the files as chips.
  */
+// Over this, the agent is told to read in parts.
+const LARGE_BYTES = 1_000_000;
+const SUMMARY_CHARS = 3000;
+
+function summaryOf(file: ChatFile): string {
+  try {
+    return fs
+      .readFileSync(summaryPath(file.path), "utf8")
+      .slice(0, SUMMARY_CHARS);
+  } catch {
+    return "";
+  }
+}
+
 export function agentText(text: string, files?: ChatFile[]): string {
   if (!files?.length) return text;
   const list = files
-    .map((f) => `- ${f.path} (${f.mediaType}, ${formatBytes(f.size)})`)
+    .map((f) => {
+      const summary = summaryOf(f);
+      const large = f.size > LARGE_BYTES ? ", large: read it in parts" : "";
+      return (
+        `- ${f.path} (${f.mediaType}, ${formatBytes(f.size)}${large})` +
+        (summary ? `\n${summary.replace(/^/gm, "  ")}` : "")
+      );
+    })
     .join("\n");
   return [
     text,
-    `Attached files, saved on this machine. Open them with your own tools:\n${list}`,
+    `Attached files, saved on this machine. They are never pasted into this message; open them with your own tools (grep or head a big one rather than reading it whole):\n${list}`,
   ]
     .filter(Boolean)
     .join("\n\n");

package/lib/attachments/policy.ts

@@ -8,6 +8,8 @@ export interface AttachmentType {
   ext: string;
   mediaType: string;
   kind: AttachmentKind;
+  // Shown on the chip: what the server does to this type on the way in.
+  note?: string;
 }
 
 const t = (
@@ -34,9 +36,22 @@ export const ATTACHMENT_TYPES: AttachmentType[] = [
   ...t("doc", `${OOXML}.presentationml.presentation`, "pptx"),
   ...t("doc", "application/vnd.oasis.opendocument.text", "odt"),
   ...t("doc", "application/rtf", "rtf"),
-  ...t("text", "text/plain", "txt", "log", "env"),
+  ...t("image", "image/heic", "heic", "heif"),
+  ...t("text", "text/plain", "txt", "log", "out", "err", "env"),
   ...t("text", "text/markdown", "md", "markdown"),
-  ...t("text", "application/json", "json", "jsonl", "ipynb"),
+  ...t("text", "application/json", "json", "jsonl", "ndjson", "ipynb"),
+  {
+    ext: "har",
+    mediaType: "application/json",
+    kind: "text",
+    note: "auth headers redacted",
+  },
+  ...t("text", "text/calendar", "ics"),
+  ...t("text", "message/rfc822", "eml"),
+  ...t("text", "text/vtt", "vtt"),
+  ...t("text", "application/x-subrip", "srt"),
+  // Svg is kept as text so nothing ever renders it.
+  ...t("text", "text/plain", "svg"),
   ...t(
     "text",
     "text/plain",
@@ -67,15 +82,67 @@ export const ATTACHMENT_TYPES: AttachmentType[] = [
     "cs",
     "php",
     "diff",
-    "patch"
+    "patch",
+    "sh",
+    "bash",
+    "zsh",
+    "fish",
+    "ini",
+    "conf",
+    "cfg",
+    "properties",
+    "tf",
+    "tfvars",
+    "hcl",
+    "graphql",
+    "gql",
+    "proto",
+    "vue",
+    "svelte",
+    "astro",
+    "dart",
+    "lua",
+    "r",
+    "scala",
+    "ex",
+    "exs",
+    "erl",
+    "zig",
+    "nix",
+    "lock",
+    "sum",
+    "mod",
+    "gitignore",
+    "gitattributes",
+    "dockerignore",
+    "editorconfig"
+  ),
+  // Files that are known by their whole name, matched without a dot.
+  ...t(
+    "text",
+    "text/plain",
+    "dockerfile",
+    "makefile",
+    "gnumakefile",
+    "procfile",
+    "gemfile",
+    "rakefile",
+    "brewfile",
+    "justfile",
+    "env.example",
+    "env.sample",
+    "env.template"
   ),
 ];
 
 export const ATTACHMENT_LIMITS = {
   // Files and images on one message.
   max: 8,
-  // One non-image file.
+  // One document, sheet or PDF.
   maxBytes: 25_000_000,
+  // One text file (logs, HAR captures, code). It is saved to disk and opened
+  // by the agent from its path, never put into the prompt, so it can be big.
+  maxTextBytes: 100_000_000,
   // One image, under the 5 MB a model accepts once base64'd.
   maxImageBytes: 3_750_000,
   // A PDF up to this goes to Claude as a document block; bigger ones, and
@@ -91,13 +158,41 @@ const BY_EXT = new Map(ATTACHMENT_TYPES.map((x) => [x.ext, x]));
 export const extOf = (name: string): string =>
   /\.([A-Za-z0-9]+)$/.exec(name)?.[1].toLowerCase() ?? "";
 
+// "Dockerfile" and ".env.example" have no extension worth the name; they are
+// matched whole, lower-cased and without a leading dot.
+const wholeName = (name: string): string =>
+  (name.split(/[\\/]/).pop() ?? "").toLowerCase().replace(/^\./, "");
+
 export const typeFor = (
   name: string,
   types: AttachmentType[] = ATTACHMENT_TYPES
-): AttachmentType | null =>
-  types === ATTACHMENT_TYPES
-    ? (BY_EXT.get(extOf(name)) ?? null)
-    : (types.find((x) => x.ext === extOf(name)) ?? null);
+): AttachmentType | null => {
+  const ext = extOf(name);
+  const whole = wholeName(name);
+  const find = (key: string) =>
+    types === ATTACHMENT_TYPES
+      ? BY_EXT.get(key)
+      : types.find((x) => x.ext === key);
+  return (ext && find(ext)) || find(whole) || null;
+};
+
+// iPhone photos: no browser or model reads them, so they are converted on
+// intake and kept as files instead of going inline with the message.
+export const isHeic = (name: string) => /^heic|^heif/.test(extOf(name));
+
+/** The byte limit for one file of this type. */
+export const limitFor = (
+  type: AttachmentType,
+  limits: Pick<
+    typeof ATTACHMENT_LIMITS,
+    "maxBytes" | "maxTextBytes" | "maxImageBytes"
+  > = ATTACHMENT_LIMITS
+): number => {
+  if (type.kind === "text") return limits.maxTextBytes;
+  if (type.kind === "image" && !isHeic(`x.${type.ext}`))
+    return limits.maxImageBytes;
+  return limits.maxBytes;
+};
 
 // For <input accept>: every extension, so the picker greys out the rest.
 export const acceptAttr = (types: AttachmentType[] = ATTACHMENT_TYPES) =>
@@ -110,7 +205,7 @@ export const formatBytes = (n: number): string =>
 
 // What a person is told when a file can't be attached.
 export const unsupportedMessage = (name: string): string =>
-  `${name}: this file type can't be attached. Supported: PDF, spreadsheets (xlsx, xls, csv), Word (docx), text, markdown, JSON, code and images.`;
+  `${name}: this file type can't be attached. Supported: images (including HEIC), PDF, spreadsheets (xlsx, xls, csv), Word and PowerPoint, HAR captures, SVG, and text files: logs, markdown, JSON, config, shell scripts, Dockerfile, Makefile and source code.`;
 
 export const tooBigMessage = (name: string, size: number, limit: number) =>
   `${name} is ${formatBytes(size)}; the limit is ${formatBytes(limit)}.`;

package/lib/attachments/prepare.ts

@@ -0,0 +1,100 @@
+import { execFile } from "child_process";
+import fs from "fs";
+import os from "os";
+import path from "path";
+import { promisify } from "util";
+import { redactHar } from "./har";
+import {
+  extOf,
+  isHeic,
+  type AttachmentKind,
+  type AttachmentType,
+} from "./policy";
+
+const run = promisify(execFile);
+
+export type Prepared =
+  | {
+      ok: true;
+      data: Buffer;
+      name: string;
+      mediaType: string;
+      kind: AttachmentKind;
+      // Saved beside the file and given to the agent with its path.
+      summary?: string;
+    }
+  | { ok: false; status: 400; error: string };
+
+export type Converter = (cmd: string, args: string[]) => Promise<unknown>;
+
+const realConverter: Converter = (cmd, args) =>
+  run(cmd, args, { timeout: 30_000 });
+
+// sips ships with macOS; ImageMagick and libheif cover Linux.
+const TOOLS = (src: string, out: string): [string, string[]][] => [
+  ["sips", ["-s", "format", "jpeg", src, "--out", out]],
+  ["magick", [src, out]],
+  ["heif-convert", [src, out]],
+];
+
+/** A JPEG of an iPhone photo, or null when this machine has no converter. */
+export async function heicToJpeg(
+  data: Buffer,
+  convert: Converter = realConverter
+): Promise<Buffer | null> {
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), "aos-heic-"));
+  try {
+    const src = path.join(dir, "in.heic");
+    const out = path.join(dir, "out.jpg");
+    fs.writeFileSync(src, data);
+    for (const [cmd, args] of TOOLS(src, out)) {
+      try {
+        await convert(cmd, args);
+        if (fs.existsSync(out)) return fs.readFileSync(out);
+      } catch {
+        // Not installed or failed: the next tool.
+      }
+    }
+    return null;
+  } finally {
+    fs.rmSync(dir, { recursive: true, force: true });
+  }
+}
+
+/** What is stored for a checked upload: secrets removed, photos converted. */
+export async function prepareUpload(
+  type: AttachmentType,
+  name: string,
+  data: Buffer,
+  convert?: Converter
+): Promise<Prepared> {
+  const keep: Prepared = {
+    ok: true,
+    data,
+    name,
+    mediaType: type.mediaType,
+    kind: type.kind,
+  };
+  if (type.ext === "har") {
+    const har = redactHar(data.toString("utf8"));
+    if (!har)
+      return {
+        ok: false,
+        status: 400,
+        error: `${name} doesn't look like a real HAR file.`,
+      };
+    return { ...keep, data: Buffer.from(har.json), summary: har.summary };
+  }
+  if (isHeic(name)) {
+    const jpeg = await heicToJpeg(data, convert);
+    if (!jpeg) return keep;
+    const stem = name.slice(0, name.length - extOf(name).length - 1);
+    return {
+      ...keep,
+      data: jpeg,
+      name: `${stem}.jpg`,
+      mediaType: "image/jpeg",
+    };
+  }
+  return keep;
+}

package/lib/attachments/store.ts

@@ -28,6 +28,10 @@ export function safeName(name: string, taken: Set<string>, n: number): string {
   return out;
 }
 
+// A short description kept beside a big file (a HAR's hosts and failures),
+// which the agent is given with the path.
+export const summaryPath = (file: string) => `${file}.summary.txt`;
+
 export function scopeDir(scope: string): string {
   return path.join(attachmentsRoot(), segment(scope) || "new");
 }
@@ -36,7 +40,8 @@ export function saveAttachment(
   scope: string,
   name: string,
   data: Buffer,
-  mediaType: string
+  mediaType: string,
+  summary?: string
 ): ChatFile {
   const dir = scopeDir(scope);
   fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
@@ -44,6 +49,7 @@ export function saveAttachment(
   const file = safeName(name, taken, taken.size + 1);
   const full = path.join(dir, file);
   fs.writeFileSync(full, data, { mode: 0o600 });
+  if (summary) fs.writeFileSync(summaryPath(full), summary, { mode: 0o600 });
   return { path: full, name: file, size: data.length, mediaType };
 }
 

package/lib/config/client-config-types.ts

@@ -36,12 +36,14 @@ export interface ClientConfig {
 export interface AttachmentConfig {
   max: number;
   maxBytes: number;
+  maxTextBytes: number;
   maxImageBytes: number;
   pdfInlineBytes: number;
   types: {
     ext: string;
     mediaType: string;
     kind: "image" | "pdf" | "sheet" | "doc" | "text";
+    note?: string;
   }[];
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saadnvd1/agent-os",
-  "version": "0.3.815",
+  "version": "0.3.817",
   "description": "Self-hosted web UI for managing Claude Code sessions",
   "bin": {
     "agent-os": "scripts/agent-os"