@cleocode/lafs-protocol 1.4.0 → 1.5.0

package/dist/src/index.js

@@ -1,9 +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 "./fieldExtraction.js";
 export * from "./conformance.js";
+export * from "./conformanceProfiles.js";
 export * from "./compliance.js";
 export * from "./tokenEstimator.js";
 export * from "./budgetEnforcement.js";
@@ -19,8 +22,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/dist/src/types.d.ts

@@ -8,6 +8,8 @@ export interface Warning {
     removeBy?: string;
 }
 export type MVILevel = 'minimal' | 'standard' | 'full' | 'custom';
+export declare const MVI_LEVELS: ReadonlySet<MVILevel>;
+export declare function isMVILevel(value: unknown): value is MVILevel;
 export interface LAFSMeta {
     specVersion: string;
     schemaVersion: string;

package/dist/src/types.js

@@ -1 +1,6 @@
-export {};
+export const MVI_LEVELS = new Set([
+    'minimal', 'standard', 'full', 'custom',
+]);
+export function isMVILevel(value) {
+    return typeof value === 'string' && MVI_LEVELS.has(value);
+}

package/lafs.md

@@ -1,7 +1,7 @@
 # LAFS: LLM-Agent-First Specification
 
 > 📚 **Documentation:** https://codluv.gitbook.io/lafs-protocol/  
-> **Version:** 1.4.0 | **Status:** Production Ready
+> **Version:** 1.5.0 | **Status:** Production Ready
 
 ## 1. Scope
 
@@ -412,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
@@ -421,16 +431,45 @@ Returns checksum and version for validation.
 - Default list/batch outputs MUST only contain fields required for next action.
 - Verbose fields SHOULD be omitted by default.
 - Systems SHOULD publish operation-level MVI budgets.
+- `_meta.mvi` MUST be one of: `minimal`, `standard`, `full`, or `custom`.
+- `_meta` is a structural envelope field and MUST always be present regardless
+  of `mvi` level. MVI levels govern the contents of `result` only; they MUST NOT
+  affect envelope structural fields (`$schema`, `_meta`, `success`, `error`,
+  `page`, `_extensions`).
+- `minimal`: MUST include only fields within `result` sufficient for the next
+  agent action (typically identifiers and status). Implementations SHOULD
+  document which fields constitute `minimal` per operation.
+- `standard` (default): MUST include all commonly useful fields for the
+  operation.
+- `full`: MUST include all available fields including verbose and
+  rarely-accessed data.
+- `custom`: MUST be set by the server when `_fields` projection has been
+  applied, indicating the result does not conform to any predefined disclosure
+  level. `custom` is not a client-requestable level.
 
 ### 9.2 Field selection (`_fields`)
 
-Clients MAY request a subset of response fields via the `_fields` request parameter.
-
-- `_fields` MUST be an array of strings identifying top-level result field names.
-- When `_fields` is present, the server MUST return only the requested fields plus any MVI-required fields for the declared disclosure level.
-- When `_fields` is absent, the server MUST return fields appropriate for the declared `_meta.mvi` disclosure level.
-- If a requested field does not exist on the resource, the server SHOULD omit it silently (no error). Servers MAY include a warning in `_meta.warnings` for unknown fields.
-- `_fields` MUST NOT affect envelope structural fields (`$schema`, `_meta`, `success`, `error`, `page`, `_extensions`); it applies only to the contents of `result`.
+Clients MAY request a subset of response fields via the `_fields` request
+parameter.
+
+- `_fields` MUST be an array of strings identifying `result` field names.
+  Path notation (e.g., `task.title`) is not defined by this specification.
+- When `result` is an array, `_fields` applies to the keys of each element.
+- When `result` is a wrapper object whose values are entities or arrays of
+  entities (e.g., `{ "task": { ... } }` or `{ "items": [...] }`), servers
+  SHOULD apply `_fields` to the nested entity fields rather than the wrapper's
+  own keys.
+- When `_fields` is present, the server MUST return only the requested fields
+  plus any MVI-required fields for the declared disclosure level.
+  The server MUST set `_meta.mvi` to `custom` in the response.
+- When `_fields` is absent, the server MUST return fields appropriate for the
+  declared `_meta.mvi` disclosure level.
+- If a requested field does not exist on the resource, the server SHOULD omit
+  it silently (no error). Servers MAY include a warning in `_meta.warnings`
+  for unknown fields.
+- `_fields` MUST NOT affect envelope structural fields (`$schema`, `_meta`,
+  `success`, `error`, `page`, `_extensions`); it applies only to the contents
+  of `result`.
 
 ### 9.3 Expansion mechanism (`_expand`)
 
@@ -447,6 +486,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.4.0",
+  "version": "1.5.0",
   "private": false,
   "type": "module",
   "description": "LLM-Agent-First Specification schemas and conformance tooling",
@@ -26,7 +26,8 @@
     "./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/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"
+    ]
+  }
+}

package/schemas/v1/error-registry.json

@@ -109,6 +109,15 @@
       "httpStatus": 413,
       "grpcStatus": "RESOURCE_EXHAUSTED",
       "cliExit": 2
+    },
+    {
+      "code": "E_FIELD_CONFLICT",
+      "category": "CONTRACT",
+      "description": "Mutually exclusive field selection modes (single-field extraction and multi-field filtering cannot be combined)",
+      "retryable": false,
+      "httpStatus": 400,
+      "grpcStatus": "INVALID_ARGUMENT",
+      "cliExit": 2
     }
   ]
 }