Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 7 additions & 6 deletions agent/instructions/content/task-agent.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,10 @@
# Помощник для дел с файлами

У тебя есть `task` — помощник со своим компьютером: Linux, Python, LibreOffice, офисные библиотеки, поиск и чтение страниц. К личным данным, переписке и подключённым сервисам у него доступа нет.
`task` — помощник с компьютером, офисными программами и поиском; личные данные, переписку и сервисы он не видит.

- Отдавай ему дела, где нужен компьютер: презентацию, документ Word или PDF, таблицу Excel или расчёт, график, перевод данных из одного формата в другой, длинное исследование по многим страницам. Короткий ответ, поиск одного факта, письмо или сообщение пиши сам.
- В `message` клади всё нужное для дела, он не видит разговор: цель, исходные данные целиком, формат, язык, объём, стиль. Личные данные — только те, без которых дело не сделать.
- Он работает в фоне. Позвав его, сразу коротко скажи человеку, что взялся и пришлёшь результат, и закончи ход — не жди и не обещай сроков точнее «через несколько минут».
- Когда придёт его отчёт — отправь человеку итог через `send_message` от первого лица («сделал презентацию, вот файл», не «помощник сделал»), а файлы по ссылкам из отчёта приложи вложениями. Не пересказывай отчёт целиком. Нет ссылки `https://…/eve/v1/sandbox-files/…`, а только путь вроде `/workspace/…` — попроси помощника тем же `agentId` отдать файл через `share_file`.
- Правка той же работы («сделай фон темнее», «добавь слайд») — тот же `task` с прежним `agentId`: его файлы ещё у него.
- Отдавай ему документы, таблицы, расчёты, графики, преобразование файлов и длинные исследования. Короткий ответ, поиск одного факта, письмо или сообщение пиши сам.
- Не урезай полезное из-за длины чата: объёмный результат поручай в аккуратном файле без отдельной просьбы о файле. Для обзора — PDF, для данных — подходящий формат; выбор человека соблюдай, короткий ответ не превращай в файл.
- В `message` передай цель, исходные данные, формат, язык, объём и стиль: он не видит разговор. Личные данные — только необходимые.
- Он работает в фоне: сразу скажи человеку, что взялся и пришлёшь результат, и закончи ход. Не жди и не обещай сроков точнее «через несколько минут».
- По отчёту отправь через `send_message` от первого лица краткое содержательное резюме и приложи файлы. Есть только путь `/workspace/…`, но нет ссылки `https://…/eve/v1/sandbox-files/…` — попроси того же помощника отдать файл через `share_file`. Файл не получился — скажи об этом, не обещай файл как готовый.
- Правку той же работы отдай `task` с прежним `agentId`: его файлы ещё у него.
2 changes: 1 addition & 1 deletion agent/instructions/content/task-files.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@
- Подпись человека помощник в документ не ставит никогда — ни картинкой, ни шрифтом, ни вырезанной из другого файла. Без инструмента подписи отдай документ без подписи и скажи, где расписаться.
- Чужую подпись, печать или штамп не переноси и не рисуй, а данные документа (дату рождения, сумму, ФИО, даты справки) не меняй так, чтобы выдать это за подлинник: это подделка документа. Откажи коротко, без морали, назови причину и законный путь (нотариальное согласие, новая справка, честные данные); повторная просьба отказ не меняет. Закрасить данные в копии, поставить надпись «Копия для …», перевести, собрать и сжать сканы — можно. Надпись передай помощнику дословно, в кавычках, как её написал человек: от себя в неё ничего не добавляй.
- Электронную подпись (файлы `.sig`, `.p7s`) помощник не проверяет: скажи, что подлинность проверяет сервис проверки электронной подписи на Госуслугах, и не называй её настоящей сам.
- Просил разобрать или посчитать — итог (число, вывод, короткий ответ) пиши текстом, даже когда просил и файл: главные числа из отчёта помощника — в сообщении, не только в файле; файл прикладывай, когда человек просил файл. Файлы помощника — ссылки `…/eve/v1/sandbox-files/…` из его отчёта — клади в `attachments` как есть: до 10 в одном сообщении, до 20 МБ каждый. Человек назвал предел размера — сверь его с отчётом, больше — попроси того же помощника сжать. Отчёт говорит, что что-то не поместилось, не прочиталось, в документе не сходится или что помощник починил либо пропустил часть данных (битые строки, дубли), — скажи это человеку с числом.
- Просил разобрать или посчитать — итог (число, вывод, короткий ответ) пиши текстом, даже когда просил и файл: главные числа из отчёта помощника — в сообщении, не только в файле; файл прикладывай и для объёмного результата, даже без просьбы о файле. Файлы помощника — ссылки `…/eve/v1/sandbox-files/…` из его отчёта — клади в `attachments` как есть: до 10 в одном сообщении, до 20 МБ каждый. Человек назвал предел размера — сверь его с отчётом, больше — попроси того же помощника сжать. Отчёт говорит, что что-то не поместилось, не прочиталось, в документе не сходится или что помощник починил либо пропустил часть данных (битые строки, дубли), — скажи это человеку с числом.
- Помощник, которому ты передал файлы человека, остаётся без интернета: нужное из сети найди сам или, отвечая человеку, отдельной задачей без файлов и их содержимого, и перепиши найденное в `message`.
- В разговоре, где помощник получал файлы, помощник, запущенный не из твоего ответа человеку (например, из ответа на отчёт), тоже работает без интернета. Ссылки из отчёта помощника там не открывай и в задачи не передавай, пока человек сам не попросит именно эту.
- Помощник пишет, что файла нет, — скажи человеку, что файл не дошёл, и попроси прислать его ещё раз или повторить просьбу: заново передать файл можешь только в ответ на сообщение человека.
Expand Down
197 changes: 197 additions & 0 deletions agent/lib/outbound-media/attachments.test.ts
Original file line number Diff line number Diff line change
@@ -1,6 +1,10 @@
import type * as Dns from "node:dns";
import type * as PublicFetch from "@agent/lib/sandbox/public-fetch";
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import {
clearSandboxSettings,
importWithSandbox,
} from "@tests/helpers/sandbox";
import {
maximumAttachmentBatchBytes,
maximumAttachmentBytes,
Expand Down Expand Up @@ -92,7 +96,200 @@ beforeEach(() => {
});

afterEach(() => {
clearSandboxSettings();
vi.unstubAllGlobals();
vi.resetModules();
});

async function signedHtml(name = "Отчёт.html") {
const modules = await importWithSandbox(async () => ({
attachments: await import("./attachments"),
files: await import("@agent/lib/sandbox/files"),
}));
fetchMock.mockResolvedValueOnce(new Response(null, { status: 200 }));
const shared = await modules.files.shareSandboxFile({
bytes: new TextEncoder().encode(
"<!doctype html><html><body>Итог 🧭</body></html>"
),
mediaType: "text/html",
name,
});
fetchMock.mockReset();
expect(modules.files.isSharedFileLink(shared.url)).toBe(true);
return { ...shared, prepare: modules.attachments.prepareAttachmentDelivery };
}

describe("signed HTML document attachments", () => {
it("follows the public storage redirect and normalizes a misleading name and type to HTML", async () => {
const shared = await signedHtml();
const bytes = new TextEncoder().encode(
"<!doctype html><html><body>Итог 🧭</body></html>"
);
fetchMock.mockResolvedValueOnce(
new Response(null, {
status: 302,
headers: { location: "https://storage.example.com/report" },
})
);
fetchMock.mockResolvedValueOnce(served(bytes, "application/octet-stream"));
const delivery = await shared.prepare([
{
kind: "file",
url: shared.url,
name: "Результат.pdf",
mimeType: "image/jpeg",
},
]);
expect(delivery.failures).toEqual([]);
expect(delivery.files[0]).toMatchObject({
filename: "Результат.html",
kind: "document",
mimeType: "text/html",
sourceUrl: shared.url,
});
expect(fetchMock).toHaveBeenCalledTimes(2);
expect(fetchMock.mock.calls[1]?.[0].toString()).toBe(
"https://storage.example.com/report"
);
});

it("keeps DNS-based SSRF protection for a genuine signed link", async () => {
const shared = await signedHtml();
dns.answer = [{ address: "127.0.0.1", family: 4 }];
dns.connect = true;
const delivery = await shared.prepare([{ kind: "file", url: shared.url }]);
expect(delivery.failures).toEqual([
{ reason: "blocked-host", url: shared.url },
]);
expect(fetchMock).not.toHaveBeenCalled();
});

it("uploads an actual signed shared HTML file as a document", async () => {
const shared = await signedHtml();
const bytes = new TextEncoder().encode(
"<!doctype html><html><body>Итог 🧭</body></html>"
);
fetchMock.mockResolvedValueOnce(served(bytes, "text/html; charset=utf-8"));
const delivery = await shared.prepare([
{ kind: "file", url: shared.url, name: shared.name },
]);
expect(delivery.failures).toEqual([]);
expect(delivery.files).toEqual([
{
data: Buffer.from(bytes),
filename: "Отчёт.html",
kind: "document",
mimeType: "text/html",
sourceUrl: shared.url,
},
]);
});

it.each(["signature", "origin", "path"] as const)(
"rejects HTML after tampering with the %s of a genuine signed link",
async (change) => {
const shared = await signedHtml();
const url = new URL(shared.url);
if (change === "signature") url.searchParams.set("sig", "forged");
if (change === "origin") url.hostname = "external.example.com";
if (change === "path") url.pathname = "/ordinary-page.html";
fetchMock.mockResolvedValueOnce(
served(
new TextEncoder().encode("<!doctype html><html>page</html>"),
"text/html"
)
);
const delivery = await shared.prepare([
{
kind: "file",
url: url.href,
name: "Отчёт.html",
mimeType: "text/html",
},
]);
expect(delivery.files).toEqual([]);
expect(delivery.failures).toEqual([
{ reason: "not-a-file", url: url.href },
]);
}
);

it("does not treat a signed non-HTML filename as permission to upload a page", async () => {
const shared = await signedHtml("Отчёт.pdf");
fetchMock.mockResolvedValueOnce(
served(
new TextEncoder().encode("<!doctype html><html>page</html>"),
"text/html"
)
);
const delivery = await shared.prepare([
{ kind: "file", url: shared.url, name: "Отчёт.html" },
]);
expect(delivery.failures).toEqual([
{ reason: "not-a-file", url: shared.url },
]);
});

it("does not trust a final redirect to a signed file when the original URL is an ordinary page", async () => {
const shared = await signedHtml();
fetchMock.mockResolvedValueOnce(
new Response(null, { status: 302, headers: { location: shared.url } })
);
fetchMock.mockResolvedValueOnce(
served(
new TextEncoder().encode("<!doctype html><html>page</html>"),
"text/html"
)
);
const url = "https://external.example.com/page.html";
const delivery = await shared.prepare([{ kind: "file", url }]);
expect(delivery.failures).toEqual([{ reason: "not-a-file", url }]);
});

it("preserves byte caps for signed HTML", async () => {
const shared = await signedHtml();
fetchMock.mockResolvedValueOnce(
new Response("<!doctype html>", {
headers: {
"content-type": "text/html",
"content-length": String(maximumAttachmentBytes + 1),
},
})
);
expect(
(await shared.prepare([{ kind: "file", url: shared.url }])).failures
).toEqual([{ reason: "oversize", url: shared.url }]);
});

it("preserves HTTP error handling for signed HTML", async () => {
const shared = await signedHtml();
fetchMock.mockResolvedValueOnce(
new Response("<!doctype html><html>Error</html>", {
status: 403,
headers: { "content-type": "text/html" },
})
);
const delivery = await shared.prepare([{ kind: "file", url: shared.url }]);
expect(delivery.files).toEqual([]);
expect(delivery.failures).toEqual([
{ reason: "http 403", url: shared.url },
]);
});

it("still rejects a signed file's redirect to a private host before fetching it", async () => {
const shared = await signedHtml();
fetchMock.mockResolvedValueOnce(
new Response(null, {
status: 302,
headers: { location: "https://127.0.0.1/private.html" },
})
);
const delivery = await shared.prepare([{ kind: "file", url: shared.url }]);
expect(delivery.failures).toEqual([
{ reason: "blocked-host", url: shared.url },
]);
expect(fetchMock).toHaveBeenCalledOnce();
});
});

describe("prepareAttachmentDelivery", () => {
Expand Down
21 changes: 16 additions & 5 deletions agent/lib/outbound-media/attachments.ts
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ import type { MessageAttachment } from "@shared/chat/message-delivery";
import { downloadWithin } from "../inbound-media/download";
import { documentByteCap, resolveMediaType } from "../inbound-media/media-type";
import { fetchPublic } from "../sandbox/public-fetch";
import { isSharedFileLink } from "../sandbox/files";

/**
* Telegram refuses a photo upload past 10 MB, which is also the cap the
Expand Down Expand Up @@ -87,6 +88,7 @@ const pageMediaTypes: ReadonlySet<string> = new Set([
]);

const mediaTypeExtensions: ReadonlyMap<string, string> = new Map([
["text/html", ".html"],
["application/pdf", ".pdf"],
["audio/aac", ".aac"],
["audio/mp4", ".m4a"],
Expand Down Expand Up @@ -203,12 +205,21 @@ async function prepareAttachment(
if (download.bytes.byteLength === 0) {
return { reason: "empty", url: attachment.url };
}
const mediaType = resolveMediaType(
download.bytes,
download.mediaType ?? attachment.mimeType
);
const sharedHtmlDocument =
startsPage(download.bytes) &&
url.pathname.toLowerCase().endsWith(".html") &&
isSharedFileLink(attachment.url);
const mediaType = sharedHtmlDocument
? "text/html"
: resolveMediaType(
download.bytes,
download.mediaType ?? attachment.mimeType
);
if (!mediaType) return { reason: "unknown-media-type", url: attachment.url };
if (pageMediaTypes.has(mediaType) || startsPage(download.bytes)) {
if (
!sharedHtmlDocument &&
(pageMediaTypes.has(mediaType) || startsPage(download.bytes))
) {
return { reason: "not-a-file", url: attachment.url };
}

Expand Down
Loading
Loading