@party-stack/foundry-ontology 0.18.1 → 0.20.0

package/lib/adapter/makeFoundryOntologyBackend.js

@@ -0,0 +1,505 @@
+import { FOUNDRY_CURRENT_USER_CONTEXT_FIELD } from "../context.js";
+import { toFoundryActionTypeName } from "../utils/actionTypeName.js";
+import { getFoundryAttachmentKind } from "../meta/foundryAttachmentMetadata.js";
+import { getFoundryActionOverrideParameterMapping } from "../meta/convertMetaActionType.js";
+import { makeFoundryBackend } from "./backend.js";
+import { makeFoundryEncryptedValues } from "./encrypted.js";
+import { foundryActionError } from "./foundryActionError.js";
+import { getFoundryValidationIssues, loadFoundrySubmissionCriteria, validateFoundryActionDraftCriteria } from "./foundryActionValidation.js";
+import { decodeFoundryMediaId, mediaReferenceToFoundryMediaId } from "./foundryMediaId.js";
+import { createFoundryCodec } from "./foundryCodec.js";
+import { uploadFoundryAttachment, uploadFoundryMedia } from "./uploads.js";
+import { Effect, Redacted, Schema, Stream } from "effect";
+import { invariant } from "@bobbyfidz/panic";
+import { MediaSets } from "@osdk/foundry.mediasets";
+import { Actions, Attachments, MediaReferenceProperties, Queries } from "@osdk/foundry.ontologies";
+import { BackendError, classifyBackendFailure } from "@party-stack/ontology-backend";
+import { certain, uncertain } from "@party-stack/ontology-spec";
+import { resolveType, unwrapType } from "@party-stack/ontology-spec/utils";
+import { byteChunks, byteSource, readableByteSource, scopedByteSource, sliceByteSource } from "@party-stack/ontology-storage/blobs";
+import { Temporal } from "temporal-polyfill";
+//#region src/adapter/makeFoundryOntologyBackend.ts
+const attachmentFailure = (kind, message) => new BackendError({
+	operation: "foundry.attachment",
+	kind,
+	message,
+	retryable: false
+});
+function isFoundryAttachmentRid(value) {
+	return /^ri\.attachments\.[^.]+\.attachment\..+$/.test(value);
+}
+function isFoundryNotFoundError(error) {
+	if (typeof error !== "object" || error === null) return false;
+	const foundryError = error;
+	return foundryError.statusCode === 404 || foundryError.errorCode === "NOT_FOUND";
+}
+function serializeOverrideValue(value) {
+	if (typeof value === "string") return value;
+	if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") return String(value);
+	if (value instanceof Date) return value.toISOString();
+	if (value instanceof Temporal.Instant) return value.toString();
+	if (value instanceof Temporal.PlainDate || value instanceof Temporal.PlainDateTime) return value.toString();
+	return JSON.stringify(value) ?? "";
+}
+function serializeActionExecutionTime(value) {
+	try {
+		const candidate = value instanceof Date ? value.toISOString() : String(value);
+		return Temporal.Instant.from(candidate).toString();
+	} catch (cause) {
+		throw new TypeError("Invalid action execution time: expected a Date or Temporal-like ISO instant.", { cause });
+	}
+}
+function getAttachmentName(attachment) {
+	if (typeof attachment !== "object" || attachment === null || Array.isArray(attachment)) return;
+	const name = attachment.name;
+	return typeof name === "string" ? name : void 0;
+}
+function getAttachmentProviderType(target) {
+	return getFoundryAttachmentKind(target?.meta);
+}
+function prepareFoundryActionInvocation(options) {
+	const actionType = options.ir.actionTypes.find((candidate) => candidate.name === options.name);
+	if (!actionType) throw new BackendError({
+		operation: "foundry.prepare",
+		kind: "InvalidRequest",
+		retryable: false,
+		actionOutcome: "not-committed",
+		message: `Unknown Foundry action type "${options.name}".`
+	});
+	const overrideMapping = getFoundryActionOverrideParameterMapping(actionType);
+	const parameterTypes = new Map(actionType.parameters.map((parameter) => [parameter.name, parameter.type]));
+	const parameters = {};
+	const uniqueIdentifierLinkIdValues = {};
+	let actionExecutionTime;
+	try {
+		for (const [parameterName, value] of Object.entries(options.parameters)) {
+			if (overrideMapping.uuidByParameterName.has(parameterName)) {
+				if (value !== void 0) uniqueIdentifierLinkIdValues[overrideMapping.uuidByParameterName.get(parameterName)] = serializeOverrideValue(value);
+				continue;
+			}
+			if (overrideMapping.nowParameterName === parameterName) {
+				if (value !== void 0) actionExecutionTime = serializeActionExecutionTime(value);
+				continue;
+			}
+			if (value !== void 0) {
+				const parameterType = parameterTypes.get(parameterName);
+				parameters[parameterName] = parameterType ? options.codec.encodeValue(parameterType, value) : value;
+			}
+		}
+	} catch (cause) {
+		throw new BackendError({
+			operation: "foundry.prepare",
+			kind: "InvalidRequest",
+			retryable: false,
+			actionOutcome: "not-committed",
+			message: "Invalid action parameters.",
+			cause: Redacted.make(cause)
+		});
+	}
+	return {
+		parameters,
+		overrides: {
+			uniqueIdentifierLinkIdValues,
+			actionExecutionTime
+		}
+	};
+}
+function withRequestSignal(client, signal) {
+	return signal ? {
+		...client,
+		fetch: (input, init) => client.fetch(input, {
+			...init,
+			signal: init?.signal ? AbortSignal.any([signal, init.signal]) : signal
+		})
+	} : client;
+}
+const makeFoundryOntologyBackend = Effect.fn("Foundry.makeBackend")(function* (opts) {
+	const context = opts.context ?? {};
+	const codec = yield* Effect.try({
+		try: () => createFoundryCodec(opts.ir),
+		catch: (cause) => new BackendError({
+			operation: "foundry.open",
+			kind: "InvalidConfiguration",
+			retryable: false,
+			message: "Invalid Foundry definition.",
+			cause: Redacted.make(cause)
+		})
+	});
+	const Validation = Schema.Struct({ result: Schema.Literals(["VALID", "INVALID"]) });
+	const ActionResponse = Schema.Struct({ validation: Schema.optional(Validation) });
+	const ValidationResponse = Schema.Struct({ validation: Validation });
+	const attachments = {
+		materializeAttachment: async (attachment, input, { target, signal }, client = opts.client) => {
+			invariant(target, "A property target must be passed to materializeAttachment in the Foundry adapter so that we know whether to target attachments or media.");
+			invariant(getAttachmentProviderType(target) === "attachment", "Foundry media references must be uploaded during action execution.");
+			const filename = byteSource(input).name ?? "";
+			if (!isFoundryAttachmentRid(attachment.id)) {
+				const uploaded = await uploadFoundryAttachment(client, input, {
+					filename,
+					signal
+				});
+				return {
+					...attachment,
+					id: uploaded.rid
+				};
+			}
+			try {
+				await Attachments.get(client, attachment.id);
+				return;
+			} catch (error) {
+				if (!isFoundryNotFoundError(error)) throw error;
+			}
+			await uploadFoundryAttachment(client, input, {
+				filename,
+				rid: attachment.id,
+				signal
+			});
+		},
+		getAttachmentContent: async (attachment, readOptions) => {
+			const client = withRequestSignal(opts.client, readOptions?.signal);
+			const userContent = await opts.users?.getAttachmentContent?.(client, attachment);
+			if (userContent) return userContent;
+			if (decodeFoundryMediaId(attachment.id)) {
+				const source = attachment.source;
+				if (!source) throw attachmentFailure("InvalidRequest", "Media reads require an object property source.");
+				const response = await MediaReferenceProperties.getMediaContent(client, client.ontologyRid, source.objectType, String(source.primaryKey), source.property, { preview: true });
+				if (!response.body) throw attachmentFailure("InvalidResponse", "Foundry returned no media body.");
+				return readableByteSource(response.body, { type: response.headers.get("content-type") ?? attachment.type });
+			}
+			const contents = await Attachments.read(client, attachment.id);
+			if (!contents.body) throw attachmentFailure("InvalidResponse", "Foundry returned no attachment body.");
+			return readableByteSource(contents.body, { type: contents.headers.get("content-type") ?? attachment.type });
+		},
+		getAttachmentMetadata: async (attachment, selection, readOptions) => {
+			const client = withRequestSignal(opts.client, readOptions?.signal);
+			const userMetadata = await opts.users?.getAttachmentMetadata?.(client, attachment, selection);
+			if (userMetadata) return userMetadata;
+			const media = decodeFoundryMediaId(attachment.id);
+			if (media) {
+				const result = {};
+				if (attachment.type !== void 0) result.type = attachment.type;
+				if (selection.includes("dimensions")) {
+					const detailed = await MediaSets.metadata(client, media.mediaSetRid, media.mediaItemRid);
+					result.size = detailed.sizeBytes;
+					if (detailed.type === "imagery" && detailed.dimensions) result.dimensions = {
+						width: detailed.dimensions.width,
+						height: detailed.dimensions.height
+					};
+				}
+				if (!selection.filter((field) => result[field] === void 0).some((field) => field !== "dimensions")) return result;
+				const source = attachment.source;
+				if (!source) throw attachmentFailure("InvalidRequest", "Media reads require an object property source.");
+				const info = await MediaReferenceProperties.getMediaMetadata(client, client.ontologyRid, source.objectType, String(source.primaryKey), source.property, { preview: true });
+				return {
+					...result,
+					size: Number(info.sizeBytes),
+					type: info.mediaType,
+					name: info.path
+				};
+			}
+			const metadata = await Attachments.get(client, attachment.id);
+			return {
+				size: Number(metadata.sizeBytes),
+				type: metadata.mediaType,
+				name: metadata.filename
+			};
+		}
+	};
+	const submitAction = async (name, parameters, context, client = opts.client) => {
+		if (!opts.ir.actionTypes.some((action) => action.name === name)) throw new BackendError({
+			operation: "foundry.applyAction",
+			kind: "InvalidRequest",
+			retryable: false,
+			actionOutcome: "not-committed",
+			message: "Unknown Foundry action type."
+		});
+		const mediaReferences = /* @__PURE__ */ new Map();
+		const attachmentIdMappings = [];
+		const attachmentIds = /* @__PURE__ */ new Map();
+		await Promise.all([...new Map((context.attachmentUploads ?? []).map((upload) => [upload.attachment.id, upload])).values()].map(async (upload) => {
+			if (getAttachmentProviderType(upload.target) !== "media") {
+				const id = (await attachments.materializeAttachment(upload.attachment, upload.blob, {
+					target: upload.target,
+					signal: context.signal
+				}, client))?.id ?? upload.attachment.id;
+				attachmentIds.set(upload.attachment.id, id);
+				if (id !== upload.attachment.id) attachmentIdMappings.push({
+					localId: upload.attachment.id,
+					remoteId: id
+				});
+				return;
+			}
+			const reference = await uploadFoundryMedia(client, upload.blob, {
+				filename: getAttachmentName(upload.blob) ?? upload.attachment.id,
+				signal: context.signal
+			});
+			mediaReferences.set(upload.attachment.id, reference);
+			attachmentIdMappings.push({
+				localId: upload.attachment.id,
+				remoteId: mediaReferenceToFoundryMediaId(reference)
+			});
+		})).catch((cause) => {
+			const error = foundryActionError("foundry.upload", cause, opts.ir, name, parameters);
+			throw new BackendError({
+				operation: error.operation,
+				kind: error.kind,
+				message: error.message,
+				retryable: error.retryable,
+				issues: error.issues,
+				cause: error.cause,
+				actionOutcome: "not-committed"
+			});
+		});
+		const actionCodec = createFoundryCodec(opts.ir, {
+			resolveMediaReference: (id) => mediaReferences.get(id),
+			resolveAttachmentId: (id) => attachmentIds.get(id)
+		});
+		let invocation;
+		try {
+			invocation = prepareFoundryActionInvocation({
+				ir: opts.ir,
+				name,
+				parameters,
+				codec: actionCodec
+			});
+		} catch (cause) {
+			if (cause instanceof BackendError) throw cause;
+			throw new BackendError({
+				operation: "foundry.prepare",
+				kind: "InvalidRequest",
+				retryable: false,
+				actionOutcome: "not-committed",
+				message: "Invalid action parameters.",
+				cause: Redacted.make(cause)
+			});
+		}
+		let result;
+		try {
+			result = await Actions.applyWithOverrides(client, client.ontologyRid, toFoundryActionTypeName(name), {
+				request: {
+					options: {
+						mode: "VALIDATE_AND_EXECUTE",
+						returnEdits: "ALL_V2_WITH_DELETIONS"
+					},
+					parameters: invocation.parameters
+				},
+				overrides: invocation.overrides
+			}, { preview: true });
+		} catch (error) {
+			throw foundryActionError("foundry.applyAction", error, opts.ir, name, parameters);
+		}
+		try {
+			Schema.decodeUnknownSync(ActionResponse)(result);
+		} catch (cause) {
+			throw new BackendError({
+				operation: "foundry.applyAction",
+				kind: "InvalidResponse",
+				retryable: false,
+				actionOutcome: "unknown",
+				message: "Foundry returned an invalid action response.",
+				cause: Redacted.make(cause)
+			});
+		}
+		if (result.validation?.result === "INVALID") throw new BackendError({
+			operation: "foundry.applyAction",
+			kind: "ValidationFailed",
+			message: "Submission failed validation.",
+			issues: getFoundryValidationIssues(result, parameters),
+			retryable: false,
+			actionOutcome: "not-committed"
+		});
+		return {
+			result,
+			attachmentIdMappings
+		};
+	};
+	const runQueryFunction = async (name, parameters, client = opts.client) => {
+		const queryFunctionType = opts.ir.queryFunctionTypes.find((candidate) => candidate.name === name);
+		if (!queryFunctionType) throw new BackendError({
+			operation: "foundry.queryFunction",
+			kind: "InvalidRequest",
+			retryable: false,
+			message: `Unknown Foundry query function type "${name}".`
+		});
+		const parameterTypes = new Map(queryFunctionType.parameters.map((parameter) => [parameter.name, parameter.type]));
+		const requestParameters = {};
+		for (const [parameterName, value] of Object.entries(parameters)) {
+			if (value === void 0) continue;
+			const parameterType = parameterTypes.get(parameterName);
+			requestParameters[parameterName] = parameterType ? codec.encodeValue(parameterType, value) : value;
+		}
+		const result = await Queries.execute(client, client.ontologyRid, name, { parameters: requestParameters });
+		try {
+			return codec.decodeValue(queryFunctionType.returnType, result.value);
+		} catch (cause) {
+			throw new BackendError({
+				operation: "foundry.queryFunction",
+				kind: "InvalidResponse",
+				retryable: false,
+				message: "Foundry returned an invalid query result.",
+				cause: Redacted.make(cause)
+			});
+		}
+	};
+	const attempt = (operation, run) => Effect.tryPromise({
+		try: run,
+		catch: (cause) => classifyBackendFailure(operation, cause)
+	});
+	const validateAction = Effect.fn("Foundry.validateAction")(function* (name, parameters) {
+		const invocation = yield* Effect.try({
+			try: () => prepareFoundryActionInvocation({
+				ir: opts.ir,
+				name,
+				parameters,
+				codec
+			}),
+			catch: (cause) => foundryActionError("foundry.validateAction", cause, opts.ir, name, parameters)
+		});
+		const result = yield* Effect.tryPromise({
+			try: (signal) => Actions.applyWithOverrides(withRequestSignal(opts.client, signal), opts.client.ontologyRid, toFoundryActionTypeName(name), {
+				request: {
+					options: { mode: "VALIDATE_ONLY" },
+					parameters: invocation.parameters
+				},
+				overrides: invocation.overrides
+			}, { preview: true }),
+			catch: (cause) => foundryActionError("foundry.validateAction", cause, opts.ir, name, parameters)
+		});
+		const { validation } = yield* Schema.decodeUnknownEffect(ValidationResponse)(result).pipe(Effect.mapError((cause) => new BackendError({
+			operation: "foundry.validateAction",
+			kind: "InvalidResponse",
+			retryable: false,
+			actionOutcome: "not-committed",
+			message: "Foundry returned an invalid validation response.",
+			cause: Redacted.make(cause)
+		})));
+		return certain(validation.result === "VALID" ? {
+			kind: "ok",
+			value: void 0
+		} : {
+			kind: "err",
+			value: getFoundryValidationIssues(result, parameters)
+		});
+	});
+	const validateActionDraft = Effect.fn("Foundry.validateActionDraft")(function* (name, parameters, live) {
+		const action = opts.ir.actionTypes.find((candidate) => candidate.name === name);
+		if (!action) return yield* new BackendError({
+			operation: "foundry.validateActionDraft",
+			kind: "InvalidRequest",
+			message: "Unknown action type.",
+			retryable: false
+		});
+		const knownParameters = /* @__PURE__ */ new Set([...Object.entries(parameters).flatMap(([key, value]) => value === void 0 ? [] : [key]), ...live.knownParameters]);
+		const missing = action.parameters.filter((parameter) => parameters[parameter.name] === void 0 && knownParameters.has(parameter.name) && !unwrapType(resolveType(opts.ir, parameter.type)).isOptional);
+		if (missing.length) return certain({
+			kind: "err",
+			value: missing.map((parameter) => ({
+				message: "A value is required.",
+				path: [parameter.name],
+				code: "required",
+				category: "input",
+				source: "parameter",
+				messageSource: "standard"
+			}))
+		});
+		if (!action.parameters.some((parameter) => parameters[parameter.name] === void 0 && !knownParameters.has(parameter.name))) return yield* validateAction(name, parameters);
+		const value = live.context?.[FOUNDRY_CURRENT_USER_CONTEXT_FIELD];
+		const userId = typeof value === "string" ? value : void 0;
+		if (!userId) return uncertain();
+		return yield* Effect.tryPromise({
+			try: async (signal) => validateFoundryActionDraftCriteria({
+				client: withRequestSignal(opts.client, signal),
+				criteria: await loadFoundrySubmissionCriteria({
+					client: withRequestSignal(opts.client, signal),
+					actionTypeName: name,
+					userId
+				}),
+				userId,
+				parameters,
+				knownParameters
+			}),
+			catch: (cause) => foundryActionError("foundry.validateActionDraft", cause, opts.ir, name, parameters)
+		});
+	});
+	return yield* makeFoundryBackend({
+		client: opts.client,
+		ir: opts.ir,
+		context,
+		watch: opts.watch,
+		encrypted: makeFoundryEncryptedValues(opts.client, opts.ir),
+		users: opts.users && {
+			objectType: opts.users.objectType,
+			loadSubset: (query, signal) => opts.users.loadSubset(opts.client, query, signal)
+		},
+		submitAction: (invocation, signal) => submitAction(invocation.name, invocation.parameters, {
+			signal,
+			attachmentUploads: invocation.attachmentUploads ? [...invocation.attachmentUploads] : void 0
+		}, withRequestSignal(opts.client, signal)),
+		decodeObject: (objectType, value) => codec.decodeObject(objectType, value),
+		queryFunction: (name, parameters, signal) => runQueryFunction(name, parameters, withRequestSignal(opts.client, signal)),
+		attachments: {
+			stage: (value, blob, settings) => attempt("attachment.stage", async (signal) => {
+				const target = settings?.target;
+				if (!target || getAttachmentProviderType(target) === "media") throw new BackendError({
+					operation: "attachment.stage",
+					kind: "NotImplemented",
+					retryable: false,
+					message: "This attachment target must be uploaded during action execution."
+				});
+				return await attachments.materializeAttachment(value, blob, {
+					target,
+					signal
+				}, withRequestSignal(opts.client, signal)) ?? value;
+			}),
+			read: (value, range) => scopedByteSource(Effect.gen(function* () {
+				if (range && (!Number.isSafeInteger(range.offset ?? 0) || (range.offset ?? 0) < 0 || range.length !== void 0 && (!Number.isSafeInteger(range.length) || range.length < 0))) return yield* new BackendError({
+					operation: "attachment.read",
+					kind: "InvalidRequest",
+					message: "Invalid byte range.",
+					retryable: false
+				});
+				const download = yield* Effect.acquireRelease(Effect.sync(() => new AbortController()), (controller) => Effect.sync(() => controller.abort()));
+				const blob = yield* attempt("attachment.read", (signal) => attachments.getAttachmentContent(value, { signal: AbortSignal.any([signal, download.signal]) }));
+				return range ? sliceByteSource(blob, range.offset ?? 0, range.length) : byteSource(blob);
+			})),
+			metadata: (value, settings) => Effect.gen(function* () {
+				const meta = yield* attempt("attachment.metadata", async (signal) => await attachments.getAttachmentMetadata?.(value, settings?.select ?? [
+					"size",
+					"type",
+					"name"
+				], { signal }) ?? {});
+				if (settings?.select || meta.size !== void 0 && meta.type !== void 0) return {
+					size: meta.size,
+					type: meta.type,
+					name: meta.name,
+					dimensions: meta.dimensions ?? void 0
+				};
+				const download = yield* Effect.acquireRelease(Effect.sync(() => new AbortController()), (controller) => Effect.sync(() => controller.abort()));
+				const blob = yield* attempt("attachment.read", (signal) => attachments.getAttachmentContent(value, { signal: AbortSignal.any([signal, download.signal]) }));
+				const source = byteSource(blob);
+				return {
+					size: source.size ?? (yield* byteChunks(source).pipe(Stream.runFold(() => 0, (total, chunk) => total + chunk.length), Effect.mapError((cause) => new BackendError({
+						operation: "attachment.metadata",
+						kind: "Unavailable",
+						message: "Attachment metadata is unavailable.",
+						retryable: true,
+						cause
+					})))),
+					type: source.type,
+					name: meta.name,
+					dimensions: meta.dimensions ?? void 0
+				};
+			}).pipe(Effect.scoped)
+		}
+	}).pipe(Effect.map((native) => ({
+		...native,
+		validateAction: (name, parameters, settings) => settings?.knownParameters ? validateActionDraft(name, parameters, {
+			context,
+			knownParameters: settings.knownParameters
+		}) : validateAction(name, parameters)
+	})));
+});
+//#endregion
+export { isFoundryNotFoundError, makeFoundryOntologyBackend };
+
+//# sourceMappingURL=makeFoundryOntologyBackend.js.map

package/lib/adapter/makeFoundryOntologyBackend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeFoundryOntologyBackend.js","names":[],"sources":["../../src/adapter/makeFoundryOntologyBackend.ts"],"sourcesContent":["import { invariant } from \"@bobbyfidz/panic\";\nimport { MediaSets } from \"@osdk/foundry.mediasets\";\nimport {\n    Actions,\n    AttachmentRid,\n    Attachments,\n    MediaReferenceProperties,\n    Queries,\n} from \"@osdk/foundry.ontologies\";\nimport { BackendError, classifyBackendFailure } from \"@party-stack/ontology-backend\";\nimport { certain, uncertain, type OntologyIR } from \"@party-stack/ontology-spec\";\nimport { resolveType, unwrapType } from \"@party-stack/ontology-spec/utils\";\nimport {\n    byteSource,\n    byteChunks,\n    readableByteSource,\n    sliceByteSource,\n    scopedByteSource,\n    type ByteInput,\n} from \"@party-stack/ontology-storage/blobs\";\nimport { Effect, Stream, Schema, Redacted, type Types } from \"effect\";\nimport { Temporal } from \"temporal-polyfill\";\nimport { FOUNDRY_CURRENT_USER_CONTEXT_FIELD } from \"../context.js\";\nimport { getFoundryActionOverrideParameterMapping } from \"../meta/convertMetaActionType.js\";\nimport { getFoundryAttachmentKind } from \"../meta/foundryAttachmentMetadata.js\";\nimport { toFoundryActionTypeName } from \"../utils/actionTypeName.js\";\nimport { makeFoundryBackend } from \"./backend.js\";\nimport { makeFoundryEncryptedValues } from \"./encrypted.js\";\nimport { foundryActionError } from \"./foundryActionError.js\";\nimport {\n    getFoundryValidationIssues,\n    loadFoundrySubmissionCriteria,\n    validateFoundryActionDraftCriteria,\n} from \"./foundryActionValidation.js\";\nimport { createFoundryCodec } from \"./foundryCodec.js\";\nimport { decodeFoundryMediaId, mediaReferenceToFoundryMediaId } from \"./foundryMediaId.js\";\nimport { uploadFoundryMedia, uploadFoundryAttachment } from \"./uploads.js\";\nimport type { OntologyClient } from \"@party-stack/foundry-client\";\nimport type {\n    BackendAttachments,\n    BackendSnapshot,\n    ValidationReport,\n    ActionReceipt,\n} from \"@party-stack/ontology-backend\";\ntype PartialAttachmentMetadata = Types.Mutable<Effect.Success<ReturnType<BackendAttachments[\"metadata\"]>>>;\ntype OntologyAttachmentIdMapping = NonNullable<ActionReceipt[\"attachmentIdMappings\"]>[number];\nimport type { attachment } from \"@party-stack/ontology-spec/values\";\nimport type { Query } from \"@party-stack/ontology-storage\";\n\nconst attachmentFailure = (kind: \"InvalidRequest\" | \"InvalidResponse\", message: string) =>\n    new BackendError({\n        operation: \"foundry.attachment\",\n        kind,\n        message,\n        retryable: false,\n    });\n\nfunction isFoundryAttachmentRid(value: string): value is AttachmentRid {\n    return /^ri\\.attachments\\.[^.]+\\.attachment\\..+$/.test(value);\n}\n\nexport function isFoundryNotFoundError(error: unknown): boolean {\n    if (typeof error !== \"object\" || error === null) {\n        return false;\n    }\n    const foundryError = error as {\n        statusCode?: unknown;\n        errorCode?: unknown;\n    };\n    return foundryError.statusCode === 404 || foundryError.errorCode === \"NOT_FOUND\";\n}\n\nexport interface FoundryUsersIntegration {\n    objectType: string;\n    loadSubset(client: OntologyClient, query: Query, signal: AbortSignal): Promise<BackendSnapshot>;\n    getAttachmentContent?(client: OntologyClient, attachment: attachment): Promise<ByteInput | undefined>;\n    getAttachmentMetadata?(\n        client: OntologyClient,\n        attachment: attachment,\n        selection: readonly (keyof PartialAttachmentMetadata)[]\n    ): Promise<PartialAttachmentMetadata | undefined>;\n}\n\ntype ApplyActionResult = Awaited<ReturnType<typeof Actions.applyWithOverrides>> & {\n    operationId?: string;\n};\n\nfunction serializeOverrideValue(value: unknown): string {\n    if (typeof value === \"string\") {\n        return value;\n    }\n    if (typeof value === \"number\" || typeof value === \"boolean\" || typeof value === \"bigint\") {\n        return String(value);\n    }\n    if (value instanceof Date) {\n        return value.toISOString();\n    }\n    if (value instanceof Temporal.Instant) {\n        return value.toString();\n    }\n    if (value instanceof Temporal.PlainDate || value instanceof Temporal.PlainDateTime) {\n        return value.toString();\n    }\n    return JSON.stringify(value) ?? \"\";\n}\n\nfunction serializeActionExecutionTime(value: unknown): string {\n    try {\n        const candidate = value instanceof Date ? value.toISOString() : String(value);\n        return Temporal.Instant.from(candidate).toString();\n    } catch (cause) {\n        throw new TypeError(\"Invalid action execution time: expected a Date or Temporal-like ISO instant.\", {\n            cause,\n        });\n    }\n}\n\nfunction getAttachmentName(attachment: unknown): string | undefined {\n    if (typeof attachment !== \"object\" || attachment === null || Array.isArray(attachment)) {\n        return undefined;\n    }\n    const name = (attachment as Record<string, unknown>).name;\n    return typeof name === \"string\" ? name : undefined;\n}\n\nfunction getAttachmentProviderType(\n    target: { meta?: Record<string, unknown> } | undefined\n): \"attachment\" | \"media\" {\n    return getFoundryAttachmentKind(target?.meta);\n}\n\nfunction prepareFoundryActionInvocation(options: {\n    ir: OntologyIR;\n    name: string;\n    parameters: Record<string, unknown>;\n    codec: ReturnType<typeof createFoundryCodec>;\n}): {\n    parameters: Record<string, unknown>;\n    overrides: {\n        uniqueIdentifierLinkIdValues: Record<string, string>;\n        actionExecutionTime?: string;\n    };\n} {\n    const actionType = options.ir.actionTypes.find((candidate) => candidate.name === options.name);\n    if (!actionType) {\n        throw new BackendError({\n            operation: \"foundry.prepare\",\n            kind: \"InvalidRequest\",\n            retryable: false,\n            actionOutcome: \"not-committed\",\n            message: `Unknown Foundry action type \"${options.name}\".`,\n        });\n    }\n    const overrideMapping = getFoundryActionOverrideParameterMapping(actionType);\n    const parameterTypes = new Map(\n        actionType.parameters.map((parameter) => [parameter.name, parameter.type])\n    );\n    const parameters: Record<string, unknown> = {};\n    const uniqueIdentifierLinkIdValues: Record<string, string> = {};\n    let actionExecutionTime: string | undefined;\n\n    try {\n        for (const [parameterName, value] of Object.entries(options.parameters)) {\n            if (overrideMapping.uuidByParameterName.has(parameterName)) {\n                if (value !== undefined) {\n                    uniqueIdentifierLinkIdValues[overrideMapping.uuidByParameterName.get(parameterName)!] =\n                        serializeOverrideValue(value);\n                }\n                continue;\n            }\n            if (overrideMapping.nowParameterName === parameterName) {\n                if (value !== undefined) {\n                    actionExecutionTime = serializeActionExecutionTime(value);\n                }\n                continue;\n            }\n            if (value !== undefined) {\n                const parameterType = parameterTypes.get(parameterName);\n                parameters[parameterName] = parameterType\n                    ? options.codec.encodeValue(parameterType, value)\n                    : value;\n            }\n        }\n    } catch (cause) {\n        throw new BackendError({\n            operation: \"foundry.prepare\",\n            kind: \"InvalidRequest\",\n            retryable: false,\n            actionOutcome: \"not-committed\",\n            message: \"Invalid action parameters.\",\n            cause: Redacted.make(cause),\n        });\n    }\n\n    return {\n        parameters,\n        overrides: {\n            uniqueIdentifierLinkIdValues,\n            actionExecutionTime,\n        },\n    };\n}\n\nexport interface FoundryOntologyBackendOptions {\n    client: OntologyClient;\n    ir: OntologyIR;\n    users?: FoundryUsersIntegration;\n    watch?: boolean;\n    context?: Record<string, unknown>;\n}\n\nfunction withRequestSignal(client: OntologyClient, signal?: AbortSignal): OntologyClient {\n    return signal\n        ? {\n              ...client,\n              fetch: (input, init) =>\n                  client.fetch(input, {\n                      ...init,\n                      signal: init?.signal ? AbortSignal.any([signal, init.signal]) : signal,\n                  }),\n          }\n        : client;\n}\n\nexport const makeFoundryOntologyBackend = Effect.fn(\"Foundry.makeBackend\")(function* (\n    opts: FoundryOntologyBackendOptions\n) {\n    const context = opts.context ?? {};\n    const codec = yield* Effect.try({\n        try: () => createFoundryCodec(opts.ir),\n        catch: (cause) =>\n            new BackendError({\n                operation: \"foundry.open\",\n                kind: \"InvalidConfiguration\",\n                retryable: false,\n                message: \"Invalid Foundry definition.\",\n                cause: Redacted.make(cause),\n            }),\n    });\n    const Validation = Schema.Struct({ result: Schema.Literals([\"VALID\", \"INVALID\"]) });\n    const ActionResponse = Schema.Struct({ validation: Schema.optional(Validation) });\n    const ValidationResponse = Schema.Struct({ validation: Validation });\n    const attachments = {\n        materializeAttachment: async (\n            attachment: attachment,\n            input: ByteInput,\n            {\n                target,\n                signal,\n            }: { target?: import(\"@party-stack/ontology-spec\").AttachmentTypeDef; signal?: AbortSignal },\n            client = opts.client\n        ) => {\n            invariant(\n                target,\n                \"A property target must be passed to materializeAttachment in the Foundry adapter so that we know whether to target attachments or media.\"\n            );\n            invariant(\n                getAttachmentProviderType(target) === \"attachment\",\n                \"Foundry media references must be uploaded during action execution.\"\n            );\n            const filename = byteSource(input).name ?? \"\";\n            if (!isFoundryAttachmentRid(attachment.id)) {\n                const uploaded = await uploadFoundryAttachment(client, input, { filename, signal });\n                return {\n                    ...attachment,\n                    id: uploaded.rid,\n                };\n            }\n            try {\n                await Attachments.get(client, attachment.id);\n                return;\n            } catch (error) {\n                if (!isFoundryNotFoundError(error)) {\n                    throw error;\n                }\n            }\n            await uploadFoundryAttachment(client, input, { filename, rid: attachment.id, signal });\n        },\n        getAttachmentContent: async (attachment: attachment, readOptions?: { signal?: AbortSignal }) => {\n            const client = withRequestSignal(opts.client, readOptions?.signal);\n            const userContent = await opts.users?.getAttachmentContent?.(client, attachment);\n            if (userContent) return userContent;\n            const media = decodeFoundryMediaId(attachment.id);\n            if (media) {\n                const source = attachment.source;\n                if (!source)\n                    throw attachmentFailure(\n                        \"InvalidRequest\",\n                        \"Media reads require an object property source.\"\n                    );\n                const response = await MediaReferenceProperties.getMediaContent(\n                    client,\n                    client.ontologyRid,\n                    source.objectType,\n                    String(source.primaryKey),\n                    source.property,\n                    { preview: true }\n                );\n                if (!response.body)\n                    throw attachmentFailure(\"InvalidResponse\", \"Foundry returned no media body.\");\n                return readableByteSource(response.body, {\n                    type: response.headers.get(\"content-type\") ?? attachment.type,\n                });\n            }\n            const contents = await Attachments.read(client, attachment.id);\n            if (!contents.body)\n                throw attachmentFailure(\"InvalidResponse\", \"Foundry returned no attachment body.\");\n            return readableByteSource(contents.body, {\n                type: contents.headers.get(\"content-type\") ?? attachment.type,\n            });\n        },\n        getAttachmentMetadata: async (\n            attachment: attachment,\n            selection: readonly (keyof PartialAttachmentMetadata)[],\n            readOptions?: { signal?: AbortSignal }\n        ): Promise<PartialAttachmentMetadata> => {\n            const client = withRequestSignal(opts.client, readOptions?.signal);\n            const userMetadata = await opts.users?.getAttachmentMetadata?.(client, attachment, selection);\n            if (userMetadata) return userMetadata;\n            const media = decodeFoundryMediaId(attachment.id);\n            if (media) {\n                const result: PartialAttachmentMetadata = {};\n                if (attachment.type !== undefined) {\n                    result.type = attachment.type;\n                }\n                if (selection.includes(\"dimensions\")) {\n                    const detailed = await MediaSets.metadata(client, media.mediaSetRid, media.mediaItemRid);\n                    result.size = detailed.sizeBytes;\n                    if (detailed.type === \"imagery\" && detailed.dimensions) {\n                        result.dimensions = {\n                            width: detailed.dimensions.width,\n                            height: detailed.dimensions.height,\n                        };\n                    }\n                }\n                const missingMetadata = selection.filter((field) => result[field] === undefined);\n                const needsBasicMetadata = missingMetadata.some((field) => field !== \"dimensions\");\n                if (!needsBasicMetadata) return result;\n\n                const source = attachment.source;\n                if (!source)\n                    throw attachmentFailure(\n                        \"InvalidRequest\",\n                        \"Media reads require an object property source.\"\n                    );\n                const info = await MediaReferenceProperties.getMediaMetadata(\n                    client,\n                    client.ontologyRid,\n                    source.objectType,\n                    String(source.primaryKey),\n                    source.property,\n                    { preview: true }\n                );\n                return {\n                    ...result,\n                    size: Number(info.sizeBytes),\n                    type: info.mediaType,\n                    name: info.path,\n                };\n            }\n            const metadata = await Attachments.get(client, attachment.id);\n            return {\n                size: Number(metadata.sizeBytes),\n                type: metadata.mediaType,\n                name: metadata.filename,\n            };\n        },\n    };\n\n    // Submission only calls provider APIs; Replica owns read-back and confirmation.\n    const submitAction = async (\n        name: string,\n        parameters: Record<string, unknown>,\n        context: {\n            attachmentUploads?: readonly import(\"@party-stack/ontology-backend\").AttachmentUpload[];\n            signal?: AbortSignal;\n        },\n        client = opts.client\n    ) => {\n        if (!opts.ir.actionTypes.some((action) => action.name === name))\n            throw new BackendError({\n                operation: \"foundry.applyAction\",\n                kind: \"InvalidRequest\",\n                retryable: false,\n                actionOutcome: \"not-committed\",\n                message: \"Unknown Foundry action type.\",\n            });\n        const mediaReferences = new Map<string, Awaited<ReturnType<typeof MediaSets.uploadMedia>>>();\n        const attachmentIdMappings: OntologyAttachmentIdMapping[] = [];\n        const attachmentIds = new Map<string, string>();\n        await Promise.all(\n            [\n                ...new Map(\n                    (context.attachmentUploads ?? []).map((upload) => [upload.attachment.id, upload])\n                ).values(),\n            ].map(async (upload) => {\n                if (getAttachmentProviderType(upload.target) !== \"media\") {\n                    const result = await attachments.materializeAttachment(\n                        upload.attachment,\n                        upload.blob,\n                        {\n                            target: upload.target,\n                            signal: context.signal,\n                        },\n                        client\n                    );\n                    const id = result?.id ?? upload.attachment.id;\n                    attachmentIds.set(upload.attachment.id, id);\n                    if (id !== upload.attachment.id)\n                        attachmentIdMappings.push({ localId: upload.attachment.id, remoteId: id });\n                    return;\n                }\n                const reference = await uploadFoundryMedia(client, upload.blob, {\n                    filename: getAttachmentName(upload.blob) ?? upload.attachment.id,\n                    signal: context.signal,\n                });\n                mediaReferences.set(upload.attachment.id, reference);\n                attachmentIdMappings.push({\n                    localId: upload.attachment.id,\n                    remoteId: mediaReferenceToFoundryMediaId(reference),\n                });\n            })\n        ).catch((cause) => {\n            const error = foundryActionError(\"foundry.upload\", cause, opts.ir, name, parameters);\n            throw new BackendError({\n                operation: error.operation,\n                kind: error.kind,\n                message: error.message,\n                retryable: error.retryable,\n                issues: error.issues,\n                cause: error.cause,\n                actionOutcome: \"not-committed\",\n            });\n        });\n        const actionCodec = createFoundryCodec(opts.ir, {\n            resolveMediaReference: (id) => mediaReferences.get(id),\n            resolveAttachmentId: (id) => attachmentIds.get(id),\n        });\n        let invocation: ReturnType<typeof prepareFoundryActionInvocation>;\n        try {\n            invocation = prepareFoundryActionInvocation({\n                ir: opts.ir,\n                name,\n                parameters,\n                codec: actionCodec,\n            });\n        } catch (cause) {\n            if (cause instanceof BackendError) throw cause;\n            throw new BackendError({\n                operation: \"foundry.prepare\",\n                kind: \"InvalidRequest\",\n                retryable: false,\n                actionOutcome: \"not-committed\",\n                message: \"Invalid action parameters.\",\n                cause: Redacted.make(cause),\n            });\n        }\n\n        let result: ApplyActionResult;\n        try {\n            result = await Actions.applyWithOverrides(\n                client,\n                client.ontologyRid,\n                toFoundryActionTypeName(name),\n                {\n                    request: {\n                        options: {\n                            mode: \"VALIDATE_AND_EXECUTE\",\n                            returnEdits: \"ALL_V2_WITH_DELETIONS\",\n                        },\n                        parameters: invocation.parameters,\n                    },\n                    overrides: invocation.overrides,\n                },\n                // oxlint-disable-next-line typescript/no-unsafe-argument\n                {\n                    preview: true,\n                    // oxlint-disable-next-line typescript/no-explicit-any\n                }\n            );\n        } catch (error) {\n            throw foundryActionError(\"foundry.applyAction\", error, opts.ir, name, parameters);\n        }\n        try {\n            Schema.decodeUnknownSync(ActionResponse)(result);\n        } catch (cause) {\n            throw new BackendError({\n                operation: \"foundry.applyAction\",\n                kind: \"InvalidResponse\",\n                retryable: false,\n                actionOutcome: \"unknown\",\n                message: \"Foundry returned an invalid action response.\",\n                cause: Redacted.make(cause),\n            });\n        }\n        if (result.validation?.result === \"INVALID\") {\n            throw new BackendError({\n                operation: \"foundry.applyAction\",\n                kind: \"ValidationFailed\",\n                message: \"Submission failed validation.\",\n                issues: getFoundryValidationIssues(result, parameters),\n                retryable: false,\n                actionOutcome: \"not-committed\",\n            });\n        }\n        return { result, attachmentIdMappings };\n    };\n\n    const runQueryFunction = async (\n        name: string,\n        parameters: Record<string, unknown>,\n        client = opts.client\n    ) => {\n        const queryFunctionType = opts.ir.queryFunctionTypes.find((candidate) => candidate.name === name);\n        if (!queryFunctionType) {\n            throw new BackendError({\n                operation: \"foundry.queryFunction\",\n                kind: \"InvalidRequest\",\n                retryable: false,\n                message: `Unknown Foundry query function type \"${name}\".`,\n            });\n        }\n\n        const parameterTypes = new Map(\n            queryFunctionType.parameters.map((parameter) => [parameter.name, parameter.type])\n        );\n        const requestParameters: Record<string, unknown> = {};\n        for (const [parameterName, value] of Object.entries(parameters)) {\n            if (value === undefined) continue;\n            const parameterType = parameterTypes.get(parameterName);\n            requestParameters[parameterName] = parameterType\n                ? codec.encodeValue(parameterType, value)\n                : value;\n        }\n\n        const result = await Queries.execute(client, client.ontologyRid, name, {\n            parameters: requestParameters,\n        });\n\n        try {\n            return codec.decodeValue(queryFunctionType.returnType, result.value);\n        } catch (cause) {\n            throw new BackendError({\n                operation: \"foundry.queryFunction\",\n                kind: \"InvalidResponse\",\n                retryable: false,\n                message: \"Foundry returned an invalid query result.\",\n                cause: Redacted.make(cause),\n            });\n        }\n    };\n    const attempt = <A>(operation: string, run: (signal: AbortSignal) => Promise<A>) =>\n        Effect.tryPromise({\n            try: run,\n            catch: (cause) => classifyBackendFailure(operation, cause),\n        });\n    const validateAction = Effect.fn(\"Foundry.validateAction\")(function* (\n        name: string,\n        parameters: Record<string, unknown>\n    ): Effect.fn.Return<ValidationReport, BackendError> {\n        const invocation = yield* Effect.try({\n            try: () => prepareFoundryActionInvocation({ ir: opts.ir, name, parameters, codec }),\n            catch: (cause) => foundryActionError(\"foundry.validateAction\", cause, opts.ir, name, parameters),\n        });\n        const result = yield* Effect.tryPromise({\n            try: (signal) =>\n                Actions.applyWithOverrides(\n                    withRequestSignal(opts.client, signal),\n                    opts.client.ontologyRid,\n                    toFoundryActionTypeName(name),\n                    {\n                        request: {\n                            options: { mode: \"VALIDATE_ONLY\" },\n                            parameters: invocation.parameters,\n                        },\n                        overrides: invocation.overrides,\n                    },\n                    { preview: true }\n                ),\n            catch: (cause) => foundryActionError(\"foundry.validateAction\", cause, opts.ir, name, parameters),\n        });\n        const { validation } = yield* Schema.decodeUnknownEffect(ValidationResponse)(result).pipe(\n            Effect.mapError(\n                (cause) =>\n                    new BackendError({\n                        operation: \"foundry.validateAction\",\n                        kind: \"InvalidResponse\",\n                        retryable: false,\n                        actionOutcome: \"not-committed\",\n                        message: \"Foundry returned an invalid validation response.\",\n                        cause: Redacted.make(cause),\n                    })\n            )\n        );\n        return certain(\n            validation.result === \"VALID\"\n                ? { kind: \"ok\" as const, value: undefined }\n                : { kind: \"err\" as const, value: getFoundryValidationIssues(result, parameters) }\n        );\n    });\n    const validateActionDraft = Effect.fn(\"Foundry.validateActionDraft\")(function* (\n        name: string,\n        parameters: Record<string, unknown>,\n        live: { knownParameters: readonly string[]; context?: Record<string, unknown> }\n    ): Effect.fn.Return<ValidationReport, BackendError> {\n        const action = opts.ir.actionTypes.find((candidate) => candidate.name === name);\n        if (!action)\n            return yield* new BackendError({\n                operation: \"foundry.validateActionDraft\",\n                kind: \"InvalidRequest\",\n                message: \"Unknown action type.\",\n                retryable: false,\n            });\n        const knownParameters = new Set([\n            ...Object.entries(parameters).flatMap(([key, value]) => (value === undefined ? [] : [key])),\n            ...live.knownParameters,\n        ]);\n        const missing = action.parameters.filter(\n            (parameter) =>\n                parameters[parameter.name] === undefined &&\n                knownParameters.has(parameter.name) &&\n                !unwrapType(resolveType(opts.ir, parameter.type)).isOptional\n        );\n        if (missing.length)\n            return certain({\n                kind: \"err\" as const,\n                value: missing.map((parameter) => ({\n                    message: \"A value is required.\",\n                    path: [parameter.name],\n                    code: \"required\",\n                    category: \"input\" as const,\n                    source: \"parameter\" as const,\n                    messageSource: \"standard\" as const,\n                })),\n            });\n        if (\n            !action.parameters.some(\n                (parameter) =>\n                    parameters[parameter.name] === undefined && !knownParameters.has(parameter.name)\n            )\n        )\n            return yield* validateAction(name, parameters);\n        const value = live.context?.[FOUNDRY_CURRENT_USER_CONTEXT_FIELD];\n        const userId = typeof value === \"string\" ? value : undefined;\n        if (!userId) return uncertain();\n        return yield* Effect.tryPromise({\n            try: async (signal) =>\n                validateFoundryActionDraftCriteria({\n                    client: withRequestSignal(opts.client, signal),\n                    criteria: await loadFoundrySubmissionCriteria({\n                        client: withRequestSignal(opts.client, signal),\n                        actionTypeName: name,\n                        userId,\n                    }),\n                    userId,\n                    parameters,\n                    knownParameters,\n                }),\n            catch: (cause) =>\n                foundryActionError(\"foundry.validateActionDraft\", cause, opts.ir, name, parameters),\n        });\n    });\n    return yield* makeFoundryBackend({\n        client: opts.client,\n        ir: opts.ir,\n        context,\n        watch: opts.watch,\n        encrypted: makeFoundryEncryptedValues(opts.client, opts.ir),\n        users: opts.users && {\n            objectType: opts.users.objectType,\n            loadSubset: (query, signal) => opts.users!.loadSubset(opts.client, query, signal),\n        },\n        submitAction: (invocation, signal) =>\n            submitAction(\n                invocation.name,\n                invocation.parameters,\n                {\n                    signal,\n                    attachmentUploads: invocation.attachmentUploads\n                        ? [...invocation.attachmentUploads]\n                        : undefined,\n                },\n                withRequestSignal(opts.client, signal)\n            ),\n        decodeObject: (objectType, value) => codec.decodeObject(objectType, value),\n        queryFunction: (name, parameters, signal) =>\n            runQueryFunction(name, parameters, withRequestSignal(opts.client, signal)),\n        attachments: {\n            stage: (value, blob, settings) =>\n                attempt(\"attachment.stage\", async (signal) => {\n                    const target = settings?.target;\n                    if (!target || getAttachmentProviderType(target) === \"media\")\n                        throw new BackendError({\n                            operation: \"attachment.stage\",\n                            kind: \"NotImplemented\",\n                            retryable: false,\n                            message: \"This attachment target must be uploaded during action execution.\",\n                        });\n                    return (\n                        (await attachments.materializeAttachment(\n                            value,\n                            blob,\n                            { target, signal },\n                            withRequestSignal(opts.client, signal)\n                        )) ?? value\n                    );\n                }),\n            read: (value, range) =>\n                scopedByteSource(\n                    Effect.gen(function* () {\n                        if (\n                            range &&\n                            (!Number.isSafeInteger(range.offset ?? 0) ||\n                                (range.offset ?? 0) < 0 ||\n                                (range.length !== undefined &&\n                                    (!Number.isSafeInteger(range.length) || range.length < 0)))\n                        )\n                            return yield* new BackendError({\n                                operation: \"attachment.read\",\n                                kind: \"InvalidRequest\",\n                                message: \"Invalid byte range.\",\n                                retryable: false,\n                            });\n                        // Fetch resolves at headers; retain cancellation through body consumption.\n                        const download = yield* Effect.acquireRelease(\n                            Effect.sync(() => new AbortController()),\n                            (controller) => Effect.sync(() => controller.abort())\n                        );\n                        const blob = yield* attempt(\"attachment.read\", (signal) =>\n                            attachments.getAttachmentContent(value, {\n                                signal: AbortSignal.any([signal, download.signal]),\n                            })\n                        );\n                        return range\n                            ? sliceByteSource(blob, range.offset ?? 0, range.length)\n                            : byteSource(blob);\n                    })\n                ),\n            metadata: (value, settings) =>\n                Effect.gen(function* () {\n                    const meta = yield* attempt(\n                        \"attachment.metadata\",\n                        async (signal) =>\n                            (await attachments.getAttachmentMetadata?.(\n                                value,\n                                settings?.select ?? [\"size\", \"type\", \"name\"],\n                                { signal }\n                            )) ?? {}\n                    );\n                    if (settings?.select || (meta.size !== undefined && meta.type !== undefined))\n                        return {\n                            size: meta.size,\n                            type: meta.type,\n                            name: meta.name,\n                            dimensions: meta.dimensions ?? undefined,\n                        };\n                    // Fetch resolves at headers; retain cancellation through body consumption.\n                    const download = yield* Effect.acquireRelease(\n                        Effect.sync(() => new AbortController()),\n                        (controller) => Effect.sync(() => controller.abort())\n                    );\n                    const blob = yield* attempt(\"attachment.read\", (signal) =>\n                        attachments.getAttachmentContent(value, {\n                            signal: AbortSignal.any([signal, download.signal]),\n                        })\n                    );\n                    const source = byteSource(blob);\n                    const size =\n                        source.size ??\n                        (yield* byteChunks(source).pipe(\n                            Stream.runFold(\n                                () => 0,\n                                (total, chunk) => total + chunk.length\n                            ),\n                            Effect.mapError(\n                                (cause) =>\n                                    new BackendError({\n                                        operation: \"attachment.metadata\",\n                                        kind: \"Unavailable\",\n                                        message: \"Attachment metadata is unavailable.\",\n                                        retryable: true,\n                                        cause,\n                                    })\n                            )\n                        ));\n                    return {\n                        size,\n                        type: source.type,\n                        name: meta.name,\n                        dimensions: meta.dimensions ?? undefined,\n                    };\n                }).pipe(Effect.scoped),\n        },\n    }).pipe(\n        Effect.map((native) => ({\n            ...native,\n            validateAction: (\n                name: string,\n                parameters: Record<string, unknown>,\n                settings?: { readonly knownParameters?: readonly string[] }\n            ) =>\n                settings?.knownParameters\n                    ? validateActionDraft(name, parameters, {\n                          context,\n                          knownParameters: settings.knownParameters,\n                      })\n                    : validateAction(name, parameters),\n        }))\n    );\n});\n"],"mappings":"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"}

package/lib/adapter/subsetFilter.d.ts

@@ -0,0 +1,14 @@
+import { SearchJsonQueryV2 } from "@osdk/foundry.ontologies";
+import { Predicate } from "@party-stack/ontology-storage";
+//#region src/adapter/subsetFilter.d.ts
+export declare const subsetFilter: (predicate: Predicate | undefined) => SearchJsonQueryV2 | undefined;
+/** Report effective placement, including supported OR branches that could not safely be sent. */
+export declare function analyzeSubsetFilter(predicate: Predicate | undefined): {
+  query: SearchJsonQueryV2 | undefined;
+  predicates: {
+    readonly path: readonly number[];
+    readonly execution: "adapter" | "candidate" | "engine" | "source";
+  }[];
+};
+//#endregion
+//# sourceMappingURL=subsetFilter.d.ts.map

package/lib/adapter/subsetFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subsetFilter.d.ts","names":[],"sources":["../../src/adapter/subsetFilter.ts"],"mappings":";;;qBAkFa,eAAY,WAAe,0BAAwB;;wBAIhD,oBAAoB,WAAW;SAAA"}