agent-first-data 0.16.0 → 0.16.1

package/assets/protocol-v1.schema.json

@@ -47,13 +47,7 @@
       "type": "object",
       "properties": {
         "kind": {"const": "progress"},
-        "progress": {
-          "type": "object",
-          "properties": {
-            "message": {"type": "string", "minLength": 1}
-          },
-          "additionalProperties": true
-        },
+        "progress": true,
         "trace": {"$ref": "#/$defs/trace"}
       },
       "required": ["kind", "progress"],
@@ -63,18 +57,7 @@
       "type": "object",
       "properties": {
         "kind": {"const": "log"},
-        "log": {
-          "type": "object",
-          "properties": {
-            "message": {"type": "string", "minLength": 1},
-            "level": {"enum": ["debug", "info", "warn", "error"]},
-            "code": false
-          },
-          "not": {
-            "required": ["code"]
-          },
-          "additionalProperties": true
-        },
+        "log": true,
         "trace": {"$ref": "#/$defs/trace"}
       },
       "required": ["kind", "log"],

package/assets/skills/agent-first-data/references/rules.md

@@ -258,7 +258,7 @@ Startup payload fields are tool-defined; `config` is recommended, while `version
 
 All use `kind` plus the same-named payload and optional `trace`. Do not split protocol events across `stdout` and `stderr`.
 
-Base validators enforce mandatory envelope/error/lifecycle rules. Strict validators additionally require object-valued `trace` on every event, complete log fields (`message`, `level`; `code` field MUST NOT appear in log payload), `retryable` on every error, and a non-empty progress `message`. Use strict validation before claiming compliance with all recommendations.
+Base validators enforce mandatory envelope/error/lifecycle rules. Strict validators additionally require object-valued `trace` on every event and `retryable` on every error. Log and progress payloads remain tool-defined in both profiles. Use strict validation before claiming compliance with all recommendations.
 
 ---
 
@@ -298,11 +298,11 @@ let span = info_span!("request", request_id = %uuid);
 let _guard = span.enter();
 ```
 
-For Go, Python, and TypeScript: emit span fields explicitly in each log event via `.field()` or equivalent event construction.
+For Go, Python, and TypeScript: emit span fields explicitly in each tool-defined log payload.
 
 ### Output fields
 
-Every log line contains `message`, `level` (debug/info/warn/error), plus span fields and event fields. Log payloads MUST NOT contain a `code` field. Do not use the log level as `code`; `code:"error"` is reserved for terminal protocol errors. Projects that need timestamps add them as extension fields (`timestamp_epoch_ms`) via emitter defaults or per-call `.field()`.
+Log payloads have no required or reserved fields. Traditional logging adapters commonly add `message` and `level` (debug/info/warn/error), plus span and event fields, but those names and meanings are adapter conventions rather than AFDATA protocol requirements. Projects that need timestamps add `timestamp_epoch_ms` explicitly.
 
 Log redaction is **by field name** (the same `_secret`/`_url` rule as all output), applied when the line is emitted. Name the secret field — `info!(api_key_secret = %key)` — rather than logging a whole object by its `Debug`/string rendering, which hides the inner field names from redaction. For structured/nested secret-bearing data, build a value, apply redaction through output formatters or redacted_value(), then emit via the standard formatting helpers — do not pass the struct to a `?`/`%`-rendered log field.
 

package/dist/format.d.ts

@@ -54,30 +54,19 @@ export declare class JsonErrorBuilder {
     build(): Event;
 }
 export declare class JsonProgressBuilder {
-    private readonly message;
-    private extensionFields;
+    private readonly payload;
     private traceValue;
     private issues;
-    constructor(message: string);
-    field(name: string, value: JsonValue): this;
-    fields(obj: unknown): this;
-    extend(obj: unknown): this;
+    constructor(payload: JsonValue);
     trace(value: Record<string, JsonValue> | undefined): this;
-    private isReservedProgressField;
     build(): Event;
 }
 export declare class JsonLogBuilder {
-    private readonly level;
-    private readonly message;
-    private extensionFields;
+    private readonly payload;
     private traceValue;
     private issues;
-    constructor(level: LogLevel, message: string);
-    field(name: string, value: JsonValue): this;
-    fields(obj: unknown): this;
-    extend(obj: unknown): this;
+    constructor(payload: JsonValue);
     trace(value: Record<string, JsonValue> | undefined): this;
-    private isReservedLogField;
     build(): Event;
 }
 /** Fluent builder for result events. */
@@ -85,9 +74,9 @@ export declare function jsonResult(payload: JsonValue): JsonResultBuilder;
 /** Fluent builder for error events. */
 export declare function jsonError(code: string, message: string): JsonErrorBuilder;
 /** Fluent builder for progress events. */
-export declare function jsonProgress(message: string): JsonProgressBuilder;
+export declare function jsonProgress(payload: JsonValue): JsonProgressBuilder;
 /** Fluent builder for log events. */
-export declare function jsonLog(level: LogLevel, message: string): JsonLogBuilder;
+export declare function jsonLog(payload: JsonValue): JsonLogBuilder;
 /** Validate one protocol event envelope. `strict` also enforces the recommended strict protocol profile (default true). */
 export declare function validateProtocolEvent(event: unknown, strict?: boolean): void;
 /** Validate finite CLI lifecycle: (log | progress)* -> exactly one terminal. `strict` also enforces the recommended strict protocol profile (default true). */
@@ -108,15 +97,12 @@ export type DecodedError = {
 };
 export type DecodedProgress = {
     kind: "progress";
-    message: string;
-    fields: Record<string, JsonValue>;
+    progress: JsonValue;
     trace?: Record<string, JsonValue>;
 };
 export type DecodedLog = {
     kind: "log";
-    level: LogLevel;
-    message: string;
-    fields: Record<string, JsonValue>;
+    log: JsonValue;
     trace?: Record<string, JsonValue>;
 };
 /** Discriminated union of decoded protocol events, narrow on `kind`. */
@@ -127,8 +113,7 @@ export declare class EventDecodeError extends Error {
 }
 /**
  * Parse one protocol line (a single JSON text value), strict-validate it, and
- * return a typed decoded event. Extension fields are every payload key beyond
- * the required ones, collected into `fields`.
+ * return a typed decoded event.
  */
 export declare function decodeProtocolEvent(text: string): DecodedEvent;
 export declare enum RedactionPolicy {

package/dist/format.js

@@ -176,53 +176,11 @@ export class JsonErrorBuilder {
     }
 }
 export class JsonProgressBuilder {
-    message;
-    extensionFields = {};
+    payload;
     traceValue = {};
     issues = [];
-    constructor(message) {
-        this.message = message;
-        if (!message || message === "")
-            this.issues.push("message must be a non-empty string");
-    }
-    field(name, value) {
-        if (this.isReservedProgressField(name)) {
-            this.issues.push(`cannot write reserved progress field ${JSON.stringify(name)}`);
-        }
-        else {
-            this.extensionFields[name] = value;
-        }
-        return this;
-    }
-    fields(obj) {
-        if (!isObject(obj)) {
-            this.issues.push("fields must be a JSON object");
-            return this;
-        }
-        for (const [key, val] of Object.entries(obj)) {
-            if (this.isReservedProgressField(key)) {
-                this.issues.push(`cannot write reserved progress field ${JSON.stringify(key)}`);
-            }
-            else {
-                this.extensionFields[key] = val;
-            }
-        }
-        return this;
-    }
-    extend(obj) {
-        if (!isObject(obj)) {
-            this.issues.push("extend must be a JSON object");
-            return this;
-        }
-        for (const [key, val] of Object.entries(obj)) {
-            if (this.isReservedProgressField(key)) {
-                this.issues.push(`cannot write reserved progress field ${JSON.stringify(key)}`);
-            }
-            else {
-                this.extensionFields[key] = val;
-            }
-        }
-        return this;
+    constructor(payload) {
+        this.payload = payload;
     }
     trace(value) {
         if (value !== undefined) {
@@ -235,71 +193,20 @@ export class JsonProgressBuilder {
         }
         return this;
     }
-    isReservedProgressField(name) {
-        return name === "message";
-    }
     build() {
         if (this.issues.length > 0) {
             throw new EventBuildError(`Failed to build progress event: ${this.issues.join("; ")}`, this.issues);
         }
-        const progress = { ...this.extensionFields };
-        progress.message = this.message;
-        const m = { kind: "progress", progress, trace: this.traceValue };
+        const m = { kind: "progress", progress: this.payload, trace: this.traceValue };
         return new Event(m);
     }
 }
 export class JsonLogBuilder {
-    level;
-    message;
-    extensionFields = {};
+    payload;
     traceValue = {};
     issues = [];
-    constructor(level, message) {
-        this.level = level;
-        this.message = message;
-        if (!message || message === "")
-            this.issues.push("message must be a non-empty string");
-        if (!isValidLogLevel(level))
-            this.issues.push(`level must be one of debug, info, warn, error`);
-    }
-    field(name, value) {
-        if (this.isReservedLogField(name)) {
-            this.issues.push(`cannot write reserved log field ${JSON.stringify(name)}`);
-        }
-        else {
-            this.extensionFields[name] = value;
-        }
-        return this;
-    }
-    fields(obj) {
-        if (!isObject(obj)) {
-            this.issues.push("fields must be a JSON object");
-            return this;
-        }
-        for (const [key, val] of Object.entries(obj)) {
-            if (this.isReservedLogField(key)) {
-                this.issues.push(`cannot write reserved log field ${JSON.stringify(key)}`);
-            }
-            else {
-                this.extensionFields[key] = val;
-            }
-        }
-        return this;
-    }
-    extend(obj) {
-        if (!isObject(obj)) {
-            this.issues.push("extend must be a JSON object");
-            return this;
-        }
-        for (const [key, val] of Object.entries(obj)) {
-            if (this.isReservedLogField(key)) {
-                this.issues.push(`cannot write reserved log field ${JSON.stringify(key)}`);
-            }
-            else {
-                this.extensionFields[key] = val;
-            }
-        }
-        return this;
+    constructor(payload) {
+        this.payload = payload;
     }
     trace(value) {
         if (value !== undefined) {
@@ -312,17 +219,11 @@ export class JsonLogBuilder {
         }
         return this;
     }
-    isReservedLogField(name) {
-        return name === "message" || name === "level" || name === "code";
-    }
     build() {
         if (this.issues.length > 0) {
             throw new EventBuildError(`Failed to build log event: ${this.issues.join("; ")}`, this.issues);
         }
-        const log = { ...this.extensionFields };
-        log.level = this.level;
-        log.message = this.message;
-        const m = { kind: "log", log, trace: this.traceValue };
+        const m = { kind: "log", log: this.payload, trace: this.traceValue };
         return new Event(m);
     }
 }
@@ -335,15 +236,12 @@ export function jsonError(code, message) {
     return new JsonErrorBuilder(code, message);
 }
 /** Fluent builder for progress events. */
-export function jsonProgress(message) {
-    return new JsonProgressBuilder(message);
+export function jsonProgress(payload) {
+    return new JsonProgressBuilder(payload);
 }
 /** Fluent builder for log events. */
-export function jsonLog(level, message) {
-    return new JsonLogBuilder(level, message);
-}
-function isValidLogLevel(level) {
-    return level === "debug" || level === "info" || level === "warn" || level === "error";
+export function jsonLog(payload) {
+    return new JsonLogBuilder(payload);
 }
 /** Validate one protocol event envelope. `strict` also enforces the recommended strict protocol profile (default true). */
 export function validateProtocolEvent(event, strict = true) {
@@ -372,10 +270,6 @@ export function validateProtocolEvent(event, strict = true) {
         return;
     if (!isObject(event.trace))
         throw new Error("event.trace is required in strict mode");
-    if (kind === "log")
-        validateStrictLog(event.log);
-    if (kind === "progress")
-        validateStrictProgress(event.progress);
     if (kind === "error")
         validateStrictError(event.error);
 }
@@ -418,25 +312,6 @@ export function validateProtocolStream(events, strict = true) {
         throw new Error("event stream must contain exactly one terminal result or error");
     }
 }
-function validateStrictLog(payload) {
-    if (!isObject(payload))
-        throw new Error("event.log must be a JSON object in strict mode");
-    // 0.16: log payload MUST NOT contain code field
-    if ("code" in payload) {
-        throw new Error("event.log.code is not allowed in strict mode");
-    }
-    if (typeof payload.message !== "string" || payload.message === "") {
-        throw new Error("event.log.message must be a non-empty string in strict mode");
-    }
-    if (!['debug', 'info', 'warn', 'error'].includes(payload.level)) {
-        throw new Error("event.log.level must be one of debug, info, warn, error in strict mode");
-    }
-}
-function validateStrictProgress(payload) {
-    if (!isObject(payload) || typeof payload.message !== "string" || payload.message === "") {
-        throw new Error("event.progress.message must be a non-empty string in strict mode");
-    }
-}
 function validateStrictError(error) {
     if (!isObject(error))
         throw new Error("event.error must be a JSON object in strict mode");
@@ -461,12 +336,9 @@ export class EventDecodeError extends Error {
     }
 }
 const ERROR_RESERVED_FIELDS = new Set(["code", "message", "hint", "retryable"]);
-const PROGRESS_RESERVED_FIELDS = new Set(["message"]);
-const LOG_RESERVED_FIELDS = new Set(["level", "message"]);
 /**
  * Parse one protocol line (a single JSON text value), strict-validate it, and
- * return a typed decoded event. Extension fields are every payload key beyond
- * the required ones, collected into `fields`.
+ * return a typed decoded event.
  */
 export function decodeProtocolEvent(text) {
     let parsed;
@@ -506,24 +378,10 @@ export function decodeProtocolEvent(text) {
                 decoded.hint = error.hint;
             return decoded;
         }
-        case "progress": {
-            const progress = event.progress;
-            const fields = {};
-            for (const [k, v] of Object.entries(progress)) {
-                if (!PROGRESS_RESERVED_FIELDS.has(k))
-                    fields[k] = v;
-            }
-            return { kind: "progress", message: progress.message, fields, trace };
-        }
-        case "log": {
-            const log = event.log;
-            const fields = {};
-            for (const [k, v] of Object.entries(log)) {
-                if (!LOG_RESERVED_FIELDS.has(k))
-                    fields[k] = v;
-            }
-            return { kind: "log", level: log.level, message: log.message, fields, trace };
-        }
+        case "progress":
+            return { kind: "progress", progress: event.progress, trace };
+        case "log":
+            return { kind: "log", log: event.log, trace };
         default:
             // Unreachable: validateProtocolEvent already constrains event.kind.
             throw new EventDecodeError(`unsupported event kind ${JSON.stringify(event.kind)}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-first-data",
-  "version": "0.16.0",
+  "version": "0.16.1",
   "description": "A naming convention that lets AI agents understand your data without being told what it means.",
   "license": "MIT",
   "repository": {