@cleocode/lafs 2026.3.74 → 2026.4.3

package/dist/src/health/index.d.ts

@@ -1,28 +1,73 @@
 /**
  * LAFS Health Check Module
  *
- * Provides health check endpoints for monitoring and orchestration
+ * Provides health check endpoints for monitoring and orchestration.
+ *
+ * @packageDocumentation
  */
+/** Configuration for the {@link healthCheck} middleware. */
 export interface HealthCheckConfig {
+    /**
+     * URL path at which the health endpoint is mounted.
+     * @defaultValue '/health'
+     */
     path?: string;
+    /**
+     * Array of custom health check functions to run on each request.
+     * @defaultValue []
+     */
     checks?: HealthCheckFunction[];
 }
+/**
+ * A function that performs a single health check.
+ *
+ * @remarks
+ * May be synchronous or asynchronous. Must return a {@link HealthCheckResult}
+ * describing the outcome.
+ */
 export type HealthCheckFunction = () => Promise<HealthCheckResult> | HealthCheckResult;
+/** Result of an individual health check. */
 export interface HealthCheckResult {
+    /** Human-readable name identifying this check. */
     name: string;
+    /** Outcome status of the check. */
     status: 'ok' | 'warning' | 'error';
+    /**
+     * Optional descriptive message providing additional detail.
+     * @defaultValue undefined
+     */
     message?: string;
+    /**
+     * Execution duration of the check in milliseconds.
+     * @defaultValue undefined
+     */
     duration?: number;
 }
+/** Aggregated health status returned by the health endpoint. */
 export interface HealthStatus {
+    /** Overall service health derived from individual check results. */
     status: 'healthy' | 'degraded' | 'unhealthy';
+    /** ISO-8601 timestamp of when the health check was performed. */
     timestamp: string;
+    /** LAFS package version. */
     version: string;
+    /** Server uptime in seconds since the middleware was initialised. */
     uptime: number;
+    /** Individual check results. */
     checks: HealthCheckResult[];
 }
 /**
- * Health check middleware for Express applications
+ * Health check middleware for Express applications.
+ *
+ * @remarks
+ * Runs all configured checks on each request, determines an overall status
+ * (`healthy`, `degraded`, or `unhealthy`), and responds with a JSON
+ * {@link HealthStatus} body. Returns HTTP 200 for healthy/degraded and 503
+ * for unhealthy. Two built-in checks (`envelopeValidation` and
+ * `tokenBudgets`) are always appended.
+ *
+ * @param config - Optional health check configuration
+ * @returns An Express-compatible middleware function that serves the health endpoint
  *
  * @example
  * ```typescript
@@ -45,9 +90,23 @@ export interface HealthStatus {
  * }));
  * ```
  */
-export declare function healthCheck(config?: HealthCheckConfig): (req: any, res: any) => Promise<void>;
+export declare function healthCheck(config?: HealthCheckConfig): (_req: unknown, res: {
+    status: (code: number) => {
+        json: (body: unknown) => void;
+    };
+}) => Promise<void>;
 /**
- * Create a database health check
+ * Create a health check function that verifies database connectivity.
+ *
+ * @remarks
+ * Wraps a caller-supplied connection check and returns a {@link HealthCheckResult}
+ * with status `'ok'` or `'error'` depending on whether the connection succeeds.
+ * Exceptions thrown by `checkConnection` are caught and reported as errors.
+ *
+ * @param config - Database check configuration
+ * @param config.checkConnection - Async function returning `true` if the database is reachable
+ * @param config.name - Display name for this check in health output
+ * @returns A {@link HealthCheckFunction} suitable for use in {@link HealthCheckConfig.checks}
  *
  * @example
  * ```typescript
@@ -65,7 +124,18 @@ export declare function createDatabaseHealthCheck(config: {
     name?: string;
 }): HealthCheckFunction;
 /**
- * Create an external service health check
+ * Create a health check function that probes an external HTTP service.
+ *
+ * @remarks
+ * Sends a `GET` request to the configured URL with an abort timeout. Returns
+ * status `'ok'` when the response is successful (HTTP 2xx) and `'error'`
+ * otherwise. Network failures and timeouts are caught and reported.
+ *
+ * @param config - External service check configuration
+ * @param config.name - Display name for this check in health output
+ * @param config.url - URL to probe for health status
+ * @param config.timeout - Request timeout in milliseconds
+ * @returns A {@link HealthCheckFunction} suitable for use in {@link HealthCheckConfig.checks}
  *
  * @example
  * ```typescript
@@ -82,16 +152,35 @@ export declare function createExternalServiceHealthCheck(config: {
     timeout?: number;
 }): HealthCheckFunction;
 /**
- * Liveness probe - basic check that service is running
+ * Liveness probe -- a minimal check confirming the process is running.
+ *
+ * @remarks
+ * Returns a 200 response with `{ status: 'alive', timestamp }`. Intended for
+ * Kubernetes liveness probes or equivalent orchestrator health checks that
+ * only need to verify the process has not crashed.
+ *
+ * @returns An Express-compatible middleware function
  *
  * @example
  * ```typescript
  * app.get('/health/live', livenessProbe());
  * ```
  */
-export declare function livenessProbe(): (req: any, res: any) => void;
+export declare function livenessProbe(): (_req: unknown, res: {
+    status: (code: number) => {
+        json: (body: unknown) => void;
+    };
+}) => void;
 /**
- * Readiness probe - check that service is ready to accept traffic
+ * Readiness probe -- verifies the service can accept traffic.
+ *
+ * @remarks
+ * Runs all configured health checks and responds with 200 (`ready`) when
+ * every check passes or 503 (`not ready`) when any check reports an error.
+ * Intended for Kubernetes readiness probes or load balancer health checks.
+ *
+ * @param config - Optional configuration with custom health check functions
+ * @returns An Express-compatible async middleware function
  *
  * @example
  * ```typescript
@@ -102,4 +191,9 @@ export declare function livenessProbe(): (req: any, res: any) => void;
  */
 export declare function readinessProbe(config?: {
     checks?: HealthCheckFunction[];
-}): (req: any, res: any) => Promise<void>;
+}): (_req: unknown, res: {
+    status: (code: number) => {
+        json: (body: unknown) => void;
+    };
+}) => Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/health/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/health/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,4DAA4D;AAC5D,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,MAAM,CAAC,EAAE,mBAAmB,EAAE,CAAC;CAChC;AAED;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,CAAC,iBAAiB,CAAC,GAAG,iBAAiB,CAAC;AAEvF,4CAA4C;AAC5C,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IAEb,mCAAmC;IACnC,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC;IAEnC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,gEAAgE;AAChE,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;IAE7C,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAElB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAEhB,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IAEf,gCAAgC;IAChC,MAAM,EAAE,iBAAiB,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,WAAW,CAAC,MAAM,GAAE,iBAAsB,IAMtD,MAAM,OAAO,EACb,KAAK;IAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK;QAAE,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;KAAE,CAAA;CAAE,mBAsDvE;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,eAAe,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,mBAAmB,CAiBtB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,mBAAmB,CA4BtB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,KACnB,MAAM,OAAO,EAAE,KAAK;IAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK;QAAE,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;KAAE,CAAA;CAAE,UAM5F;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,MAAM,GAAE;IAAE,MAAM,CAAC,EAAE,mBAAmB,EAAE,CAAA;CAAO,IAE1E,MAAM,OAAO,EACb,KAAK;IAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK;QAAE,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;KAAE,CAAA;CAAE,mBAiCvE"}

package/dist/src/health/index.js

@@ -1,7 +1,9 @@
 /**
  * LAFS Health Check Module
  *
- * Provides health check endpoints for monitoring and orchestration
+ * Provides health check endpoints for monitoring and orchestration.
+ *
+ * @packageDocumentation
  */
 import { createRequire } from 'node:module';
 const require = createRequire(import.meta.url);
@@ -13,7 +15,17 @@ catch {
     pkg = require('../../../package.json');
 }
 /**
- * Health check middleware for Express applications
+ * Health check middleware for Express applications.
+ *
+ * @remarks
+ * Runs all configured checks on each request, determines an overall status
+ * (`healthy`, `degraded`, or `unhealthy`), and responds with a JSON
+ * {@link HealthStatus} body. Returns HTTP 200 for healthy/degraded and 503
+ * for unhealthy. Two built-in checks (`envelopeValidation` and
+ * `tokenBudgets`) are always appended.
+ *
+ * @param config - Optional health check configuration
+ * @returns An Express-compatible middleware function that serves the health endpoint
  *
  * @example
  * ```typescript
@@ -37,9 +49,9 @@ catch {
  * ```
  */
 export function healthCheck(config = {}) {
-    const { path = '/health', checks = [] } = config;
+    const { path: _path = '/health', checks = [] } = config;
     const startTime = Date.now();
-    return async (req, res) => {
+    return async (_req, res) => {
         const timestamp = new Date().toISOString();
         const checkResults = [];
         // Run all health checks
@@ -55,22 +67,22 @@ export function healthCheck(config = {}) {
                     name: 'unknown',
                     status: 'error',
                     message: error instanceof Error ? error.message : 'Check failed',
-                    duration: Date.now() - start
+                    duration: Date.now() - start,
                 });
             }
         }
         // Add default checks
         checkResults.push({
             name: 'envelopeValidation',
-            status: 'ok'
+            status: 'ok',
         });
         checkResults.push({
             name: 'tokenBudgets',
-            status: 'ok'
+            status: 'ok',
         });
         // Determine overall status
-        const hasErrors = checkResults.some(c => c.status === 'error');
-        const hasWarnings = checkResults.some(c => c.status === 'warning');
+        const hasErrors = checkResults.some((c) => c.status === 'error');
+        const hasWarnings = checkResults.some((c) => c.status === 'warning');
         const status = hasErrors
             ? 'unhealthy'
             : hasWarnings
@@ -81,14 +93,24 @@ export function healthCheck(config = {}) {
             timestamp,
             version: pkg.version,
             uptime: Math.floor((Date.now() - startTime) / 1000),
-            checks: checkResults
+            checks: checkResults,
         };
         const statusCode = status === 'healthy' ? 200 : status === 'degraded' ? 200 : 503;
         res.status(statusCode).json(health);
     };
 }
 /**
- * Create a database health check
+ * Create a health check function that verifies database connectivity.
+ *
+ * @remarks
+ * Wraps a caller-supplied connection check and returns a {@link HealthCheckResult}
+ * with status `'ok'` or `'error'` depending on whether the connection succeeds.
+ * Exceptions thrown by `checkConnection` are caught and reported as errors.
+ *
+ * @param config - Database check configuration
+ * @param config.checkConnection - Async function returning `true` if the database is reachable
+ * @param config.name - Display name for this check in health output
+ * @returns A {@link HealthCheckFunction} suitable for use in {@link HealthCheckConfig.checks}
  *
  * @example
  * ```typescript
@@ -108,20 +130,31 @@ export function createDatabaseHealthCheck(config) {
             return {
                 name: config.name || 'database',
                 status: isConnected ? 'ok' : 'error',
-                message: isConnected ? 'Connected' : 'Connection failed'
+                message: isConnected ? 'Connected' : 'Connection failed',
             };
         }
         catch (error) {
             return {
                 name: config.name || 'database',
                 status: 'error',
-                message: error instanceof Error ? error.message : 'Database check failed'
+                message: error instanceof Error ? error.message : 'Database check failed',
             };
         }
     };
 }
 /**
- * Create an external service health check
+ * Create a health check function that probes an external HTTP service.
+ *
+ * @remarks
+ * Sends a `GET` request to the configured URL with an abort timeout. Returns
+ * status `'ok'` when the response is successful (HTTP 2xx) and `'error'`
+ * otherwise. Network failures and timeouts are caught and reported.
+ *
+ * @param config - External service check configuration
+ * @param config.name - Display name for this check in health output
+ * @param config.url - URL to probe for health status
+ * @param config.timeout - Request timeout in milliseconds
+ * @returns A {@link HealthCheckFunction} suitable for use in {@link HealthCheckConfig.checks}
  *
  * @example
  * ```typescript
@@ -139,14 +172,14 @@ export function createExternalServiceHealthCheck(config) {
             const controller = new AbortController();
             const timeout = setTimeout(() => controller.abort(), config.timeout || 5000);
             const response = await fetch(config.url, {
-                signal: controller.signal
+                signal: controller.signal,
             });
             clearTimeout(timeout);
             return {
                 name: config.name,
                 status: response.ok ? 'ok' : 'error',
                 message: response.ok ? 'Service healthy' : `HTTP ${response.status}`,
-                duration: Date.now() - start
+                duration: Date.now() - start,
             };
         }
         catch (error) {
@@ -154,13 +187,20 @@ export function createExternalServiceHealthCheck(config) {
                 name: config.name,
                 status: 'error',
                 message: error instanceof Error ? error.message : 'Service unreachable',
-                duration: Date.now() - start
+                duration: Date.now() - start,
             };
         }
     };
 }
 /**
- * Liveness probe - basic check that service is running
+ * Liveness probe -- a minimal check confirming the process is running.
+ *
+ * @remarks
+ * Returns a 200 response with `{ status: 'alive', timestamp }`. Intended for
+ * Kubernetes liveness probes or equivalent orchestrator health checks that
+ * only need to verify the process has not crashed.
+ *
+ * @returns An Express-compatible middleware function
  *
  * @example
  * ```typescript
@@ -168,15 +208,23 @@ export function createExternalServiceHealthCheck(config) {
  * ```
  */
 export function livenessProbe() {
-    return (req, res) => {
+    return (_req, res) => {
         res.status(200).json({
             status: 'alive',
-            timestamp: new Date().toISOString()
+            timestamp: new Date().toISOString(),
         });
     };
 }
 /**
- * Readiness probe - check that service is ready to accept traffic
+ * Readiness probe -- verifies the service can accept traffic.
+ *
+ * @remarks
+ * Runs all configured health checks and responds with 200 (`ready`) when
+ * every check passes or 503 (`not ready`) when any check reports an error.
+ * Intended for Kubernetes readiness probes or load balancer health checks.
+ *
+ * @param config - Optional configuration with custom health check functions
+ * @returns An Express-compatible async middleware function
  *
  * @example
  * ```typescript
@@ -186,7 +234,7 @@ export function livenessProbe() {
  * ```
  */
 export function readinessProbe(config = {}) {
-    return async (req, res) => {
+    return async (_req, res) => {
         const checkResults = [];
         if (config.checks) {
             for (const check of config.checks) {
@@ -198,23 +246,24 @@ export function readinessProbe(config = {}) {
                     checkResults.push({
                         name: 'unknown',
                         status: 'error',
-                        message: error instanceof Error ? error.message : 'Check failed'
+                        message: error instanceof Error ? error.message : 'Check failed',
                     });
                 }
             }
         }
-        const hasErrors = checkResults.some(c => c.status === 'error');
+        const hasErrors = checkResults.some((c) => c.status === 'error');
         if (hasErrors) {
             res.status(503).json({
                 status: 'not ready',
-                checks: checkResults
+                checks: checkResults,
             });
         }
         else {
             res.status(200).json({
                 status: 'ready',
-                checks: checkResults
+                checks: checkResults,
             });
         }
     };
 }
+//# sourceMappingURL=index.js.map

package/dist/src/health/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/health/index.ts"],"names":[],"mappings":"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"}

package/dist/src/index.d.ts

@@ -1,24 +1,35 @@
-export * from "./types.js";
-export * from "./errorRegistry.js";
-export * from "./deprecationRegistry.js";
-export * from "./validateEnvelope.js";
-export * from "./envelope.js";
-export * from "./flagSemantics.js";
-export * from "./fieldExtraction.js";
-export * from "./flagResolver.js";
-export * from "./mviProjection.js";
-export * from "./conformance.js";
-export * from "./conformanceProfiles.js";
-export * from "./compliance.js";
-export * from "./tokenEstimator.js";
-export * from "./budgetEnforcement.js";
-export * from "./mcpAdapter.js";
-export * from "./discovery.js";
-export { lafsErrorToProblemDetails, PROBLEM_DETAILS_CONTENT_TYPE } from './problemDetails.js';
+/**
+ * LAFS (LLM-Agent-First Specification) TypeScript SDK.
+ *
+ * @packageDocumentation
+ *
+ * @remarks
+ * This is the main entry point for the `@cleocode/lafs` package. It re-exports all
+ * public modules including envelope creation, validation, conformance checking,
+ * error registry, flag resolution, MVI projection, A2A integration, and operational
+ * primitives (health, shutdown, circuit breaker).
+ */
+export type { Artifact, BuildLafsExtensionOptions, CreateTaskOptions, DataPart, ExtensionNegotiationMiddlewareOptions, ExtensionNegotiationResult, FilePart, JSONRPCErrorResponse, LafsA2AConfig, LafsExtensionParams, LafsSendMessageParams, ListTasksOptions, ListTasksResult, Message, MessageSendConfiguration, Part, PushNotificationConfig, PushNotificationDeliveryResult, PushTransport, SendMessageResponse, SendMessageSuccessResponse, StreamIteratorOptions, Task, TaskArtifactUpdateEvent, TaskState, TaskStatus, TaskStatusUpdateEvent, TaskStreamEvent, TextPart, } from './a2a/index.js';
+export { A2A_EXTENSIONS_HEADER, AGENT_CARD_PATH, attachLafsEnvelope, buildLafsExtension, createFileArtifact, createLafsArtifact, createTextArtifact, ExtensionSupportRequiredError, extensionNegotiationMiddleware, formatExtensionsHeader, getExtensionParams, HTTP_EXTENSION_HEADER, INTERRUPTED_STATES, InvalidStateTransitionError, isExtensionRequired, isInterruptedState, isTerminalState, isValidTransition, LAFS_EXTENSION_URI, LafsA2AResult, negotiateExtensions, PushNotificationConfigStore, PushNotificationDispatcher, parseExtensionsHeader, streamTaskEvents, TaskArtifactAssembler, TaskEventBus, TaskImmutabilityError, TaskManager, TaskNotFoundError, TaskRefinementError, TERMINAL_STATES, VALID_TRANSITIONS, } from './a2a/index.js';
+export * from './budgetEnforcement.js';
+export * from './circuit-breaker/index.js';
+export * from './compliance.js';
+export * from './conformance.js';
+export * from './conformanceProfiles.js';
+export * from './deprecationRegistry.js';
+export * from './discovery.js';
+export * from './envelope.js';
+export * from './errorRegistry.js';
+export * from './fieldExtraction.js';
+export * from './flagResolver.js';
+export * from './flagSemantics.js';
+export * from './health/index.js';
+export * from './mviProjection.js';
+export { isNativeAvailable } from './native-loader.js';
 export type { LafsProblemDetails } from './problemDetails.js';
-export * from "./health/index.js";
-export * from "./shutdown/index.js";
-export * from "./circuit-breaker/index.js";
-export { LafsA2AResult, createLafsArtifact, createTextArtifact, createFileArtifact, isExtensionRequired, getExtensionParams, AGENT_CARD_PATH, HTTP_EXTENSION_HEADER, LAFS_EXTENSION_URI, A2A_EXTENSIONS_HEADER, parseExtensionsHeader, negotiateExtensions, formatExtensionsHeader, buildLafsExtension, ExtensionSupportRequiredError, extensionNegotiationMiddleware, TERMINAL_STATES, INTERRUPTED_STATES, VALID_TRANSITIONS, isValidTransition, isTerminalState, isInterruptedState, InvalidStateTransitionError, TaskImmutabilityError, TaskNotFoundError, TaskRefinementError, TaskManager, attachLafsEnvelope, TaskEventBus, PushNotificationConfigStore, PushNotificationDispatcher, TaskArtifactAssembler, streamTaskEvents, } from "./a2a/index.js";
-export type { LafsA2AConfig, LafsSendMessageParams, LafsExtensionParams, ExtensionNegotiationResult, BuildLafsExtensionOptions, ExtensionNegotiationMiddlewareOptions, CreateTaskOptions, ListTasksOptions, ListTasksResult, TaskStreamEvent, StreamIteratorOptions, PushNotificationDeliveryResult, PushTransport, } from "./a2a/index.js";
-export type { Task, TaskState, TaskStatus, Artifact, Part, Message, PushNotificationConfig, MessageSendConfiguration, TaskStatusUpdateEvent, TaskArtifactUpdateEvent, SendMessageResponse, SendMessageSuccessResponse, JSONRPCErrorResponse, TextPart, DataPart, FilePart, } from "./a2a/index.js";
+export { lafsErrorToProblemDetails, PROBLEM_DETAILS_CONTENT_TYPE } from './problemDetails.js';
+export * from './shutdown/index.js';
+export * from './tokenEstimator.js';
+export * from './types.js';
+export * from './validateEnvelope.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,YAAY,EACV,QAAQ,EACR,yBAAyB,EACzB,iBAAiB,EACjB,QAAQ,EACR,qCAAqC,EACrC,0BAA0B,EAC1B,QAAQ,EACR,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,OAAO,EACP,wBAAwB,EACxB,IAAI,EACJ,sBAAsB,EACtB,8BAA8B,EAC9B,aAAa,EACb,mBAAmB,EACnB,0BAA0B,EAC1B,qBAAqB,EACrB,IAAI,EACJ,uBAAuB,EACvB,SAAS,EACT,UAAU,EACV,qBAAqB,EACrB,eAAe,EACf,QAAQ,GACT,MAAM,gBAAgB,CAAC;AAKxB,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,6BAA6B,EAC7B,8BAA8B,EAC9B,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,2BAA2B,EAC3B,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EAEjB,kBAAkB,EAElB,aAAa,EACb,mBAAmB,EACnB,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB,EAErB,YAAY,EACZ,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EAEnB,eAAe,EACf,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AACxB,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AAEnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAC9F,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC"}

package/dist/src/index.js

@@ -1,34 +1,46 @@
-export * from "./types.js";
-export * from "./errorRegistry.js";
-export * from "./deprecationRegistry.js";
-export * from "./validateEnvelope.js";
-export * from "./envelope.js";
-export * from "./flagSemantics.js";
-export * from "./fieldExtraction.js";
-export * from "./flagResolver.js";
-export * from "./mviProjection.js";
-export * from "./conformance.js";
-export * from "./conformanceProfiles.js";
-export * from "./compliance.js";
-export * from "./tokenEstimator.js";
-export * from "./budgetEnforcement.js";
-export * from "./mcpAdapter.js";
-export * from "./discovery.js";
-export { lafsErrorToProblemDetails, PROBLEM_DETAILS_CONTENT_TYPE } from './problemDetails.js';
-// Operations & Reliability
-export * from "./health/index.js";
-export * from "./shutdown/index.js";
-export * from "./circuit-breaker/index.js";
+/**
+ * LAFS (LLM-Agent-First Specification) TypeScript SDK.
+ *
+ * @packageDocumentation
+ *
+ * @remarks
+ * This is the main entry point for the `@cleocode/lafs` package. It re-exports all
+ * public modules including envelope creation, validation, conformance checking,
+ * error registry, flag resolution, MVI projection, A2A integration, and operational
+ * primitives (health, shutdown, circuit breaker).
+ */
 // A2A Integration
 // Explicitly re-export to avoid naming conflicts with discovery types
 // (AgentCard, AgentSkill, AgentCapabilities, AgentExtension).
 // For full A2A types, import from '@cleocode/lafs/a2a'.
-export { 
-// Bridge
-LafsA2AResult, createLafsArtifact, createTextArtifact, createFileArtifact, isExtensionRequired, getExtensionParams, AGENT_CARD_PATH, HTTP_EXTENSION_HEADER, 
+export { A2A_EXTENSIONS_HEADER, AGENT_CARD_PATH, attachLafsEnvelope, buildLafsExtension, createFileArtifact, createLafsArtifact, createTextArtifact, ExtensionSupportRequiredError, extensionNegotiationMiddleware, formatExtensionsHeader, getExtensionParams, HTTP_EXTENSION_HEADER, INTERRUPTED_STATES, InvalidStateTransitionError, isExtensionRequired, isInterruptedState, isTerminalState, isValidTransition, 
 // Extensions (T098)
-LAFS_EXTENSION_URI, A2A_EXTENSIONS_HEADER, parseExtensionsHeader, negotiateExtensions, formatExtensionsHeader, buildLafsExtension, ExtensionSupportRequiredError, extensionNegotiationMiddleware, 
-// Task Lifecycle (T099)
-TERMINAL_STATES, INTERRUPTED_STATES, VALID_TRANSITIONS, isValidTransition, isTerminalState, isInterruptedState, InvalidStateTransitionError, TaskImmutabilityError, TaskNotFoundError, TaskRefinementError, TaskManager, attachLafsEnvelope, 
+LAFS_EXTENSION_URI, 
+// Bridge
+LafsA2AResult, negotiateExtensions, PushNotificationConfigStore, PushNotificationDispatcher, parseExtensionsHeader, streamTaskEvents, TaskArtifactAssembler, 
 // Streaming and Async (T101)
-TaskEventBus, PushNotificationConfigStore, PushNotificationDispatcher, TaskArtifactAssembler, streamTaskEvents, } from "./a2a/index.js";
+TaskEventBus, TaskImmutabilityError, TaskManager, TaskNotFoundError, TaskRefinementError, 
+// Task Lifecycle (T099)
+TERMINAL_STATES, VALID_TRANSITIONS, } from './a2a/index.js';
+export * from './budgetEnforcement.js';
+export * from './circuit-breaker/index.js';
+export * from './compliance.js';
+export * from './conformance.js';
+export * from './conformanceProfiles.js';
+export * from './deprecationRegistry.js';
+export * from './discovery.js';
+export * from './envelope.js';
+export * from './errorRegistry.js';
+export * from './fieldExtraction.js';
+export * from './flagResolver.js';
+export * from './flagSemantics.js';
+// Operations & Reliability
+export * from './health/index.js';
+export * from './mviProjection.js';
+export { isNativeAvailable } from './native-loader.js';
+export { lafsErrorToProblemDetails, PROBLEM_DETAILS_CONTENT_TYPE } from './problemDetails.js';
+export * from './shutdown/index.js';
+export * from './tokenEstimator.js';
+export * from './types.js';
+export * from './validateEnvelope.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAkCH,kBAAkB;AAClB,sEAAsE;AACtE,8DAA8D;AAC9D,wDAAwD;AACxD,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,6BAA6B,EAC7B,8BAA8B,EAC9B,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,2BAA2B,EAC3B,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,iBAAiB;AACjB,oBAAoB;AACpB,kBAAkB;AAClB,SAAS;AACT,aAAa,EACb,mBAAmB,EACnB,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,gBAAgB,EAChB,qBAAqB;AACrB,6BAA6B;AAC7B,YAAY,EACZ,qBAAqB,EACrB,WAAW,EACX,iBAAiB,EACjB,mBAAmB;AACnB,wBAAwB;AACxB,eAAe,EACf,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AACxB,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,2BAA2B;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,yBAAyB,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAC9F,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,uBAAuB,CAAC"}

package/dist/src/mviProjection.d.ts

@@ -1,19 +1,56 @@
 /**
  * MVI-aware envelope projection.
+ *
  * Strips fields based on declared MVI level to reduce token cost.
- * At 'minimal': ~38 tokens per error (vs ~162 at 'full').
+ * At `'minimal'`: approximately 38 tokens per error (vs approximately 162 at `'full'`).
+ *
+ * @remarks
+ * Projection is applied after field extraction and before serialization. The four
+ * MVI levels control which envelope fields are included in the output:
+ * - `'minimal'`: only fields required for agent control flow
+ * - `'standard'`: all commonly useful fields (current default)
+ * - `'full'` / `'custom'`: complete envelope, no stripping
+ *
+ * @since 1.5.0
  */
 import type { LAFSEnvelope, MVILevel } from './types.js';
 /**
  * Project an envelope to the declared MVI verbosity level.
- * - 'minimal': Only fields required for agent control flow
- * - 'standard': All commonly useful fields (current default behavior)
- * - 'full': Complete echo-back including request parameters
- * - 'custom': No projection (controlled by _fields)
+ *
+ * @param envelope - The full LAFS envelope to project
+ * @param mviLevel - Override MVI level; falls back to `envelope._meta.mvi`, then `'standard'`
+ * @returns A plain object containing only the fields appropriate for the resolved MVI level
+ *
+ * @remarks
+ * MVI levels control projection behavior:
+ * - `'minimal'`: only fields required for agent control flow (success, error code, retry info)
+ * - `'standard'`: all commonly useful fields (current default behavior)
+ * - `'full'`: complete echo-back including request parameters
+ * - `'custom'`: no projection (controlled by field extraction layer)
+ *
+ * @example
+ * ```ts
+ * const minimal = projectEnvelope(envelope, 'minimal');
+ * // minimal contains only: success, _meta (requestId, contextVersion), result/error
+ * ```
  */
 export declare function projectEnvelope(envelope: LAFSEnvelope, mviLevel?: MVILevel): Record<string, unknown>;
 /**
  * Estimate token count for a projected envelope.
- * Uses simple heuristic: 1 token per ~4 characters of JSON.
+ *
+ * @param projected - The projected envelope object to estimate
+ * @returns The estimated token count based on JSON serialization length
+ *
+ * @remarks
+ * Uses a simple heuristic of 1 token per approximately 4 characters of
+ * JSON-serialized output. This is an approximation suitable for budget
+ * enforcement, not an exact tokenizer count.
+ *
+ * @example
+ * ```ts
+ * const tokens = estimateProjectedTokens(projectEnvelope(envelope, 'minimal'));
+ * // tokens ~= Math.ceil(JSON.stringify(projected).length / 4)
+ * ```
  */
 export declare function estimateProjectedTokens(projected: Record<string, unknown>): number;
+//# sourceMappingURL=mviProjection.d.ts.map

package/dist/src/mviProjection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mviProjection.d.ts","sourceRoot":"","sources":["../../src/mviProjection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,YAAY,EAAuB,QAAQ,EAAE,MAAM,YAAY,CAAC;AAa9E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,YAAY,EACtB,QAAQ,CAAC,EAAE,QAAQ,GAClB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWzB;AAoGD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAGlF"}