File size: 1,746 Bytes
0f821de | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 | /** Configuration and stable diagnostics for session references. */
/** Hard maximum references accepted by one message. */
export const MAX_REFERENCES = 3
/** Default number of discovery candidates returned to a host. */
export const DEFAULT_CANDIDATE_LIMIT = 50
/** Minimum automatic UTF-8 budget for one rendered reference JSON object. */
export const DEFAULT_MAX_REFERENCE_BYTES = 65_536
/** Session-reference service configuration. */
export interface Config {
/** Maximum distinct source sessions referenced by one message, from one to three. */
maxReferences?: number
/** Default host candidate-list limit. */
candidateLimit?: number
/** Explicit maximum rendered UTF-8 bytes per source; absent uses the model-relative budget with a 64 KiB floor. */
maxReferenceBytes?: number
/** Fraction of the model context window per source, estimated at four bytes per token; between zero and one. */
referenceContextFraction?: number
}
/** Stable failure codes exposed to host adapters. */
export type SessionReferenceErrorCode =
| 'SESSION_REFERENCE_INVALID_CONFIG'
| 'SESSION_REFERENCE_INVALID_REFERENCE'
| 'SESSION_REFERENCE_SELF_REFERENCE'
| 'SESSION_REFERENCE_TOO_MANY'
| 'SESSION_REFERENCE_READ_FAILED'
| 'SESSION_REFERENCE_BUDGET_EXCEEDED'
| 'SESSION_REFERENCE_CANCELLED'
/** Typed session-reference failure suitable for host protocol error mapping. */
export class SessionReferenceError extends Error {
/** @param message Human-readable diagnosis. @param code Stable routing code. @param options Optional cause. */
constructor(
message: string,
readonly code: SessionReferenceErrorCode,
options?: ErrorOptions,
) {
super(message, options)
this.name = 'SessionReferenceError'
}
}
|