Evenfire is an intelligence layer platform for running LLM agents that take real actions, on your infrastructure
TypeScript
import type { FileClass, FileClassification, FileDetection } from './fileClassifier'
export type FileReferenceSource =
| { kind: 'attachment'; attachmentId: string; messageId: string }
| { kind: 'gfs'; drive: string; resourceId: string; gfsUri: string; version: number }
export interface FileReferenceDigest {
algorithm: 'sha256'
/** 64 lowercase hex characters. */
hex: string
}
export interface FileReferenceV1 {
schemaVersion: 1
/**
* Derived, never chosen: `att:<messageId>:<attachmentId>@sha256:<hex>` or
* `gfs:<drive>:<resourceId>@v<version>`.
*/
id: string
source: FileReferenceSource
/** Base name, NFC, 1-255 code points, no `/` or ASCII control characters (DEL included). Builders normalize to NFC. */
name: string
declaredMediaType: string | null
detectedMediaType: string
class: FileClass
detection: FileDetection
mismatch: boolean
byteLength: number
/** Required for attachments, optional for GFS resources. */
digest?: FileReferenceDigest
textReadable: boolean
reader: 'text' | 'none'
modelImageInput: 'candidate' | 'unsupported'
}
export type FileReferenceErrorCode =
| 'FILE_REFERENCE_SCHEMA_VERSION_UNSUPPORTED'
| 'FILE_REFERENCE_INVALID'
export type FileReferenceParseResult =
| { ok: true; value: FileReferenceV1 }
| { ok: false; code: FileReferenceErrorCode; message: string }
export declare const FILE_REFERENCE_SCHEMA_VERSION: 1
/**
* The maximum number of file references one message may carry. mcp-host
* admission and the Desktop composer both enforce this single export, so the
* two cannot disagree.
*/
export declare const FILE_REFERENCE_MAX_COUNT: 10
export declare function parseFileReferenceV1(input: unknown): FileReferenceParseResult
/**
* A JSON string literal of `value` in which every control, format, line or
* paragraph separator and default-ignorable character is escaped and angle
* brackets are neutralized, for text a model reads.
*/
export declare function quotePromptValue(value: string): string
export declare function deriveFileReferenceId(
source: FileReferenceSource,
digest?: FileReferenceDigest
): string
export declare function buildAttachmentFileReference(fields: {
attachmentId: string
messageId: string
name: string
declaredMediaType?: string | null
byteLength: number
digestHex: string
classification: FileClassification
}): FileReferenceParseResult
export declare function buildGfsFileReference(fields: {
drive: string
resourceId: string
gfsUri: string
version: number
name: string
declaredMediaType?: string | null
byteLength: number
digestHex?: string
classification: FileClassification
}): FileReferenceParseResult