@segmentstream/agent 0.17.6 → 0.17.7

package/dist/_chunks/{build-metadata-BkfakQLL.mjs → build-metadata-DNcZwjhU.mjs}

@@ -4,7 +4,7 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
-var version = "0.17.6";
+var version = "0.17.7";
 function agentBuild(environment = process.env) {
 	return {
 		agent: version,

package/dist/extension/lib/build-metadata.mjs

@@ -4,5 +4,5 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
-import { t as agentBuild } from "../../_chunks/build-metadata-BkfakQLL.mjs";
+import { t as agentBuild } from "../../_chunks/build-metadata-DNcZwjhU.mjs";
 export { agentBuild };

package/dist/extension/lib/file-grant.d.ts

@@ -0,0 +1,3 @@
+export declare const transientFileStatus: (status: number) => boolean;
+/** Only for reads that issue a file grant; never wrap a delivery or a mutation. */
+export declare function fetchFileGrant(send: () => Promise<Response>): Promise<Response>;

package/dist/extension/lib/file-grant.mjs

@@ -0,0 +1,25 @@
+import { fileURLToPath as __eveFileURLToPath } from "node:url";
+import { dirname as __eveDirname } from "node:path";
+import { createRequire as __eveCreateRequire } from "node:module";
+const __filename = __eveFileURLToPath(import.meta.url);
+__eveDirname(__filename);
+__eveCreateRequire(import.meta.url);
+const transientFileStatus = (status) => [
+	429,
+	502,
+	503,
+	504
+].includes(status);
+async function fetchFileGrant(send) {
+	for (let attempt = 0;; attempt++) {
+		const response = await send();
+		if (!transientFileStatus(response.status) || attempt === 2) return response;
+		const retryAfter = response.headers.get("retry-after");
+		const seconds = Number(retryAfter);
+		const delay = retryAfter === null ? 500 * 2 ** attempt : Number.isFinite(seconds) ? Math.max(0, seconds * 1e3) : Date.parse(retryAfter) - Date.now();
+		if (!Number.isFinite(delay) || delay < 0 || delay > 5e3) return response;
+		await response.body?.cancel();
+		await new Promise((resolve) => setTimeout(resolve, delay));
+	}
+}
+export { fetchFileGrant, transientFileStatus };

package/dist/extension/lib/ontology-tools.d.ts

@@ -11,6 +11,13 @@ export declare class OntologyToolRejected extends Error {
 export declare class OntologyActionNotPermitted extends Error {
     readonly code = "ontology_action_not_permitted";
 }
+/** A known read-only file request can be repeated; action outcomes keep their existing fence. */
+export declare class OntologyFileUnavailable extends Error {
+    readonly code: string;
+    readonly requestId: string | undefined;
+    readonly retryable = true;
+    constructor(code: string, requestId: string | undefined, options?: ErrorOptions);
+}
 /** A fresh, permission-filtered catalog. Listing tools cannot run an action's prepare step. */
 export declare function ontologyTools(options?: {
     readonly principal?: SessionAuthContext | null;

package/dist/extension/lib/ontology-tools.mjs

@@ -17,6 +17,16 @@ var OntologyToolRejected = class extends Error {
 var OntologyActionNotPermitted = class extends Error {
 	code = "ontology_action_not_permitted";
 };
+var OntologyFileUnavailable = class extends Error {
+	code;
+	requestId;
+	retryable = true;
+	constructor(code, requestId, options) {
+		super(`${code}${requestId === void 0 ? "" : ` (${requestId})`}`, options);
+		this.code = code;
+		this.requestId = requestId;
+	}
+};
 function ontologyTools(options = {}) {
 	const runtimeSources = options.runtimeSources ?? new Map();
 	async function rpc(memberId, method, params, signal) {
@@ -61,6 +71,8 @@ function ontologyTools(options = {}) {
 			const result = object(body.result);
 			if (method === "tools/list" && Array.isArray(result.tools)) runtimeSources.set(memberId, result.tools.map(object).some((tool) => object(tool._meta)[RUNTIME_SOURCE_PROTOCOL] === 1));
 			if (result.isError === true) {
+				const failure = object(result.structuredContent);
+				if (method === "tools/call" && params.name === "files_download" && failure.retryable === true && ["ontology_updating", "storage_unavailable"].includes(String(failure.error))) throw new OntologyFileUnavailable(String(failure.error), typeof failure.request_id === "string" ? failure.request_id : void 0, { cause: result });
 				const message = (Array.isArray(result.content) ? result.content : []).map(object).filter((part) => part.type === "text" && typeof part.text === "string").map((part) => part.text).join("\n");
 				if ([
 					"action_rejected",
@@ -87,6 +99,7 @@ function ontologyTools(options = {}) {
 				reference,
 				error: diagnostic
 			});
+			if (error instanceof OntologyFileUnavailable) throw new OntologyFileUnavailable(error.code, error.requestId, { cause: diagnostic });
 			if (error instanceof OntologyToolRejected) throw new OntologyToolRejected(String(object(diagnostic).message), { cause: diagnostic });
 			throw new Error(`The ontology request failed (${reference}).`, { cause: diagnostic });
 		}
@@ -246,4 +259,4 @@ function promotionTarget(input) {
 		}
 	};
 }
-export { OntologyActionNotPermitted, OntologyToolRejected, actionToolName, ontologyToolLabels, ontologyTools, promotionTarget };
+export { OntologyActionNotPermitted, OntologyFileUnavailable, OntologyToolRejected, actionToolName, ontologyToolLabels, ontologyTools, promotionTarget };

package/dist/extension/lib/stored-files.mjs

@@ -7,18 +7,27 @@ __eveCreateRequire(import.meta.url);
 import { i as memberIdOf } from "../../_chunks/principal-B6u41vIf.mjs";
 import { redactDiagnostic } from "./diagnostics.mjs";
 import { object } from "./confirmation-description.mjs";
-import { ontologyTools } from "./ontology-tools.mjs";
+import { OntologyFileUnavailable, ontologyTools } from "./ontology-tools.mjs";
 import { createHash } from "node:crypto";
 async function readStoredFile(input, principal, options = {}) {
 	const memberId = memberIdOf(principal);
 	if (memberId === void 0) throw new Error("A current member is required to read a stored file.");
-	const raw = await ontologyTools({
+	const tools = ontologyTools({
 		...options,
 		principal
-	}).rpc(memberId, "tools/call", {
-		name: "files_download",
-		arguments: input
 	});
+	const readGrant = async () => {
+		for (let attempt = 0;; attempt++) try {
+			return await tools.rpc(memberId, "tools/call", {
+				name: "files_download",
+				arguments: input
+			});
+		} catch (error) {
+			if (!(error instanceof OntologyFileUnavailable) || attempt === 2) throw error;
+			await new Promise((resolve) => setTimeout(resolve, error.code === "ontology_updating" ? 5e3 : 500 * 2 ** attempt));
+		}
+	};
+	const raw = await readGrant();
 	const result = object(raw.structuredContent), file = object(result.file), grant = object(result.download);
 	const headers = object(grant.headers);
 	const size = file.size;

package/dist/extension/lib/telegram/adapter.mjs

@@ -20,7 +20,7 @@ import { archivedRoutingMessages } from "../group-routing/routing-context.mjs";
 import { dispatchStructuredMessage, structuredMessage } from "./structured.mjs";
 import { scopedAddress, sessionPolicy } from "./sessions.mjs";
 import { handleWorkspaceCallback, isWorkspaceCallback } from "./callbacks.mjs";
-import { t as agentBuild } from "../../../_chunks/build-metadata-BkfakQLL.mjs";
+import { t as agentBuild } from "../../../_chunks/build-metadata-DNcZwjhU.mjs";
 import { attachmentLifecycle } from "./lifecycle.mjs";
 import { observedMessages } from "./observed.mjs";
 import { expireDeferredCards, handleDeferredCallback, isDeferredCallback } from "./deferred-confirmations.mjs";

package/dist/extension/lib/telegram/attachments-send.d.ts

@@ -20,6 +20,9 @@ export interface SentFile {
     readonly error?: string;
     readonly detail?: string;
     readonly reference?: string;
+    readonly status?: number;
+    readonly retryable?: boolean;
+    readonly requestId?: string;
 }
 /** Bare ids are document records; explicit references select other entities and file properties. */
 export declare function sendAttachmentsInput(value: Record<string, unknown>): SendAttachmentsInput;

package/dist/extension/lib/telegram/attachments-send.mjs

@@ -16,6 +16,7 @@ import { ACT_AS_HEADER } from "../ontology-connection.mjs";
 import { AttachmentError, CONVERSATION_HEADER, SESSION_HEADER } from "../attachments.mjs";
 import { TELEGRAM_PLACEHOLDER_TOKEN, TELEGRAM_PROXY_ORIGIN, telegramProxyFetch } from "./proxy-fetch.mjs";
 import { attachmentOwner } from "../attachment-tools.mjs";
+import { fetchFileGrant, transientFileStatus } from "../file-grant.mjs";
 const MAXIMUM_PHOTO_BYTES = 10485760;
 const MAXIMUM_DOCUMENT_BYTES = 52428800;
 const PHOTOS = new Set([
@@ -133,12 +134,14 @@ async function sendAttachmentsInOrder(options) {
 	const uploads = [];
 	for (const [index, reference] of options.input.documentIds.entries()) {
 		let filename = "";
+		let requestId;
 		try {
-			const response = await fetchImpl(`${origin}/api/ontology/agent/files/${[
+			const path = [
 				reference.entity,
 				reference.id,
 				...reference.property === void 0 ? [] : [reference.property]
-			].map(encodeURIComponent).join("/")}`, {
+			].map(encodeURIComponent).join("/");
+			const response = await fetchFileGrant(async () => fetchImpl(`${origin}/api/ontology/agent/files/${path}`, {
 				headers: {
 					authorization: `Bearer ${await token()}`,
 					[ACT_AS_HEADER]: owner.memberId,
@@ -147,10 +150,18 @@ async function sendAttachmentsInOrder(options) {
 				},
 				redirect: "error",
 				signal: AbortSignal.timeout(3e4)
-			});
+			}));
 			if (!response.ok) {
-				const code = response.status === 404 ? "not_found" : response.status === 403 ? "forbidden" : response.status === 422 ? "unsupported" : "unavailable";
-				throw refused(code, `The ontology refused the file (${code}).`);
+				const body = await response.json().catch(() => void 0);
+				const upstream = isRecord(body) ? body : {};
+				const ref = upstream.request_id ?? upstream.requestId;
+				requestId = typeof ref === "string" ? ref : void 0;
+				const code = response.status === 404 ? "not_found" : response.status === 403 ? "forbidden" : response.status === 422 ? "unsupported" : response.status === 503 && upstream.error === "ontology_updating" ? "ontology_updating" : transientFileStatus(response.status) ? "retryable" : "unavailable";
+				throw new AttachmentError({
+					code,
+					message: code,
+					status: response.status
+				});
 			}
 			const answer = await response.json();
 			const file = isRecord(answer) ? answer.file : void 0;
@@ -191,7 +202,12 @@ async function sendAttachmentsInOrder(options) {
 				filename,
 				error: error instanceof AttachmentError ? error.code : "unavailable",
 				detail: failureText(errorId, "attachment", locale),
-				reference: errorId
+				reference: errorId,
+				...error instanceof AttachmentError && error.status !== void 0 ? {
+					status: error.status,
+					retryable: transientFileStatus(error.status)
+				} : {},
+				...requestId === void 0 ? {} : { requestId }
 			};
 		}
 	}

package/dist/extension/lib/telegram/health.mjs

@@ -4,7 +4,7 @@ import { createRequire as __eveCreateRequire } from "node:module";
 const __filename = __eveFileURLToPath(import.meta.url);
 __eveDirname(__filename);
 __eveCreateRequire(import.meta.url);
-import { t as agentBuild } from "../../../_chunks/build-metadata-BkfakQLL.mjs";
+import { t as agentBuild } from "../../../_chunks/build-metadata-DNcZwjhU.mjs";
 import { runtimeRequestFailure } from "./runtime-request.mjs";
 import { GET } from "eve/channels";
 const HEALTH_ROUTE = "/eve/v1/telegram/health";

package/dist/extension/lib/telegram/lifecycle.mjs

@@ -9,7 +9,7 @@ import { object } from "../confirmation-description.mjs";
 import { n as currentInboundRequest, p as reportTelegramError } from "../../../_chunks/inbound-request-DxRm5LC8.mjs";
 import { needsConfirmation } from "../confirmations.mjs";
 import { OntologyActionNotPermitted, actionToolName, ontologyTools } from "../ontology-tools.mjs";
-import { t as agentBuild } from "../../../_chunks/build-metadata-BkfakQLL.mjs";
+import { t as agentBuild } from "../../../_chunks/build-metadata-DNcZwjhU.mjs";
 var AttachmentLifecycleNotPermitted = class extends Error {
 	code = "attachment_lifecycle_not_permitted";
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@segmentstream/agent",
-  "version": "0.17.6",
+  "version": "0.17.7",
   "description": "Mount a SegmentStream workspace's agent on eve: the ontology as tools, acting as the member who writes, and Telegram through the workspace's connection.",
   "license": "Apache-2.0",
   "author": "SegmentStream",
@@ -66,7 +66,7 @@
   },
   "dependencies": {
     "@chat-adapter/telegram": "4.41.0",
-    "@segmentstream-cloud/ontology": "0.54.2",
+    "@segmentstream-cloud/ontology": "0.54.3",
     "@vercel/oidc": "^3.8.4",
     "ai": "^7.0.128",
     "csv-parse": "^7.0.3",