@cleocode/lafs-protocol 1.3.2 → 1.4.1

package/dist/src/index.d.ts

@@ -1,8 +1,12 @@
 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 "./conformance.js";
+export * from "./conformanceProfiles.js";
+export * from "./compliance.js";
 export * from "./tokenEstimator.js";
 export * from "./budgetEnforcement.js";
 export * from "./mcpAdapter.js";
@@ -10,6 +14,6 @@ export * from "./discovery.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, TaskManager, attachLafsEnvelope, } from "./a2a/index.js";
-export type { LafsA2AConfig, LafsSendMessageParams, LafsExtensionParams, ExtensionNegotiationResult, BuildLafsExtensionOptions, ExtensionNegotiationMiddlewareOptions, CreateTaskOptions, ListTasksOptions, ListTasksResult, } from "./a2a/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";

package/dist/src/index.js

@@ -1,8 +1,12 @@
 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 "./conformance.js";
+export * from "./conformanceProfiles.js";
+export * from "./compliance.js";
 export * from "./tokenEstimator.js";
 export * from "./budgetEnforcement.js";
 export * from "./mcpAdapter.js";
@@ -17,8 +21,10 @@ export * from "./circuit-breaker/index.js";
 // For full A2A types, import from '@cleocode/lafs-protocol/a2a'.
 export { 
 // Bridge
-LafsA2AResult, createLafsArtifact, createTextArtifact, createFileArtifact, isExtensionRequired, getExtensionParams, 
+LafsA2AResult, createLafsArtifact, createTextArtifact, createFileArtifact, isExtensionRequired, getExtensionParams, AGENT_CARD_PATH, HTTP_EXTENSION_HEADER, 
 // 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, TaskManager, attachLafsEnvelope, } from "./a2a/index.js";
+TERMINAL_STATES, INTERRUPTED_STATES, VALID_TRANSITIONS, isValidTransition, isTerminalState, isInterruptedState, InvalidStateTransitionError, TaskImmutabilityError, TaskNotFoundError, TaskRefinementError, TaskManager, attachLafsEnvelope, 
+// Streaming and Async (T101)
+TaskEventBus, PushNotificationConfigStore, PushNotificationDispatcher, TaskArtifactAssembler, streamTaskEvents, } from "./a2a/index.js";

package/lafs.md

@@ -1,7 +1,7 @@
 # LAFS: LLM-Agent-First Specification
 
 > 📚 **Documentation:** https://codluv.gitbook.io/lafs-protocol/  
-> **Version:** 1.3.1 | **Status:** Production Ready
+> **Version:** 1.4.1 | **Status:** Production Ready
 
 ## 1. Scope
 
@@ -130,7 +130,7 @@ All responses MUST conform to `schemas/v1/envelope.schema.json`.
     "requestId": "req_123",
     "transport": "cli",
     "strict": true,
-    "mvi": true,
+    "mvi": "standard",
     "contextVersion": 0
   },
   "success": true,
@@ -142,7 +142,6 @@ All responses MUST conform to `schemas/v1/envelope.schema.json`.
 
 ### 6.1 Envelope invariants
 
-- Exactly one of `result` or `error` MUST be non-null.
 - `success=true` implies `error=null` or error omitted.
 - `success=false` implies `result=null` and `error` MUST be present.
 - The `page` and `error` fields are optional when their value would be null. In strict mode, producers SHOULD omit these fields rather than set them to null.
@@ -413,6 +412,16 @@ Returns checksum and version for validation.
 - **Validation**: Use `mode=summary` to verify sync state
 - **Default recommendation**: `delta` mode for agent-optimal behavior
 
+### 8.2 Lazy Context Retrieval
+
+To reduce token and I/O overhead, implementations SHOULD support lazy retrieval semantics:
+
+- Clients SHOULD start with `mode=summary` and request `mode=delta` only when `version` or `checksum` changes.
+- Delta responses SHOULD be bounded by `limit` and MAY return paged deltas.
+- Servers SHOULD treat context retrieval as task-scoped and MUST NOT leak entries across `contextId` domains.
+- When a consumer requests additional context beyond MVI defaults, servers MAY return progressive context slices rather than full ledgers.
+- If requested context scope cannot be satisfied within declared budget, servers SHOULD fail with `E_MVI_BUDGET_EXCEEDED`.
+
 ---
 
 ## 9. MVI and Progressive Disclosure
@@ -448,6 +457,9 @@ Clients MAY request expanded/nested data via the `_expand` request parameter.
 - List operations SHOULD return deterministic `page` metadata.
 - Pagination mode (offset or cursor) MUST be documented.
 - Mixed pagination modes in one request MUST fail validation.
+- `page.limit` SHOULD represent the effective item window after `_fields`/`_expand` processing.
+- When `_meta.mvi` is `minimal` and projected payload size exceeds budget, servers SHOULD reduce `page.limit` rather than silently truncate item content.
+- If limit reduction still cannot satisfy declared budget, servers MUST fail with `E_MVI_BUDGET_EXCEEDED`.
 
 ### 9.5 Token Budget Signaling
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/lafs-protocol",
-  "version": "1.3.2",
+  "version": "1.4.1",
   "private": false,
   "type": "module",
   "description": "LLM-Agent-First Specification schemas and conformance tooling",
@@ -22,7 +22,12 @@
     "./a2a/bindings": {
       "import": "./dist/src/a2a/bindings/index.js",
       "types": "./dist/src/a2a/bindings/index.d.ts"
-    }
+    },
+    "./schemas/v1/envelope.schema.json": "./schemas/v1/envelope.schema.json",
+    "./schemas/v1/error-registry.json": "./schemas/v1/error-registry.json",
+    "./schemas/v1/context-ledger.schema.json": "./schemas/v1/context-ledger.schema.json",
+    "./schemas/v1/discovery.schema.json": "./schemas/v1/discovery.schema.json",
+    "./schemas/v1/conformance-profiles.json": "./schemas/v1/conformance-profiles.json"
   },
   "files": [
     "dist",

package/schemas/v1/conformance-profiles.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "version": "1.0.0",
+  "tiers": {
+    "core": [
+      "envelope_schema_valid",
+      "envelope_invariants",
+      "error_code_registered"
+    ],
+    "standard": [
+      "envelope_schema_valid",
+      "envelope_invariants",
+      "error_code_registered",
+      "transport_mapping_consistent",
+      "meta_mvi_present",
+      "meta_strict_present",
+      "strict_mode_behavior",
+      "pagination_mode_consistent",
+      "strict_mode_enforced"
+    ],
+    "complete": [
+      "envelope_schema_valid",
+      "envelope_invariants",
+      "error_code_registered",
+      "transport_mapping_consistent",
+      "context_mutation_failure",
+      "context_preservation_valid",
+      "meta_mvi_present",
+      "meta_strict_present",
+      "strict_mode_behavior",
+      "pagination_mode_consistent",
+      "strict_mode_enforced"
+    ]
+  }
+}