agent-contracts 0.30.2 → 0.30.3

package/README.md

@@ -1476,6 +1476,10 @@ Templates can use these built-in helpers:
 | `notEmpty` | `{{#if (notEmpty obj)}}` | True when object has at least one key |
 | `inc` | `{{inc @index}}` | Increment number by 1 (for 1-based indexing) |
 | `yamlBlock` | `{{{yamlBlock obj}}}` | Render value as YAML-formatted text |
+| `jsonBlock` | `{{{jsonBlock obj}}}` | Render value as pretty-printed JSON |
+| `yamlFrontmatter` | `{{{yamlFrontmatter obj}}}` | Render value as YAML frontmatter (`---` delimiters) |
+| `handoffPayload` | `(handoffPayload handoffType)` | Resolve handoff payload (`example` or schema skeleton) |
+| `handoffEnvelope` | `(handoffEnvelope handoffType id=@key)` | Build `{ type, version, payload }` envelope object |
 | `lookupPayloadFields` | `{{#each (lookupPayloadFields schema)}}` | Extract schema field info (name, type, required, enum); resolves `allOf` internally |
 | `join` | `{{join arr ", "}}` | Join array elements with separator |
 | `contains` | `{{#if (contains arr "x")}}` | True when array includes value |

package/dist/cli.js

@@ -55025,33 +55025,7 @@ function buildNavigationIndex(dsl) {
   };
 }
 
-// src/renderer/renderer.ts
-Handlebars.registerHelper("eq", (a3, b3) => a3 === b3);
-Handlebars.registerHelper("notEmpty", (obj) => {
-  if (!obj || typeof obj !== "object") return false;
-  return Object.keys(obj).length > 0;
-});
-Handlebars.registerHelper("inc", (val) => val + 1);
-Handlebars.registerHelper(
-  "lookupPayloadFields",
-  (schema) => {
-    const effective = resolveAllOf(schema ?? {});
-    const props = effective["properties"];
-    if (!props) return [];
-    const requiredSet = new Set(
-      effective["required"] ?? []
-    );
-    return Object.entries(props).map(([name, sub]) => {
-      const enumVals = sub["enum"];
-      return {
-        name,
-        type: sub["type"] ?? "any",
-        required: requiredSet.has(name),
-        enum: enumVals ? enumVals.join(" | ") : void 0
-      };
-    });
-  }
-);
+// src/renderer/serialization.ts
 function toYamlLines(obj, indent) {
   const pad = "  ".repeat(indent);
   if (obj === null || obj === void 0) return [`${pad}null`];
@@ -55118,9 +55092,146 @@ function toYamlLines(obj, indent) {
   }
   return [`${pad}${String(obj)}`];
 }
-Handlebars.registerHelper("yamlBlock", (obj) => {
+function toYamlString(obj) {
   return toYamlLines(obj, 0).join("\n");
+}
+function toJsonString(obj, indent = 2) {
+  return JSON.stringify(obj, null, indent);
+}
+function toYamlFrontmatter(obj) {
+  const body = toYamlString(obj);
+  if (!body) return "---\n---\n";
+  return `---
+${body}
+---
+`;
+}
+
+// src/renderer/handoff-payload.ts
+function resolveHandoffPayload(handoffType) {
+  if (!handoffType) return {};
+  if (handoffType.example && typeof handoffType.example === "object" && !Array.isArray(handoffType.example)) {
+    return handoffType.example;
+  }
+  if (handoffType.schema && typeof handoffType.schema === "object") {
+    return exampleFromSchema(handoffType.schema);
+  }
+  return {};
+}
+function buildHandoffEnvelope(handoffType, idOverride) {
+  if (!handoffType) return {};
+  const type = idOverride ?? handoffType.id;
+  return {
+    ...type ? { type } : {},
+    ...handoffType.version !== void 0 ? { version: handoffType.version } : {},
+    payload: resolveHandoffPayload(handoffType)
+  };
+}
+function exampleFromSchema(schema) {
+  const effective = resolveAllOf(schema);
+  if (effective["$ref"] && !effective["properties"] && !effective["type"]) {
+    return {};
+  }
+  return exampleFromJsonSchema(effective);
+}
+function exampleFromJsonSchema(schema) {
+  const type = schema["type"];
+  if (type === "object" || schema["properties"]) {
+    return exampleFromObjectSchema(schema);
+  }
+  return {};
+}
+function exampleFromObjectSchema(schema) {
+  const props = schema["properties"];
+  if (!props) return {};
+  const required = new Set(
+    schema["required"] ?? []
+  );
+  const result = {};
+  for (const [key, propSchema] of Object.entries(props)) {
+    if (!required.has(key)) continue;
+    result[key] = exampleFromPropertySchema(
+      propSchema,
+      key
+    );
+  }
+  return result;
+}
+function exampleFromPropertySchema(schema, propName) {
+  const effective = resolveAllOf(schema);
+  if (effective["example"] !== void 0) return effective["example"];
+  if (effective["const"] !== void 0) return effective["const"];
+  const enumVals = effective["enum"];
+  if (enumVals && enumVals.length > 0) return enumVals[0];
+  const type = effective["type"];
+  if (type === "string" || !type && effective["format"]) {
+    return `<${propName}>`;
+  }
+  if (type === "integer") return 0;
+  if (type === "number") return 0;
+  if (type === "boolean") return false;
+  if (type === "array") {
+    const items = effective["items"];
+    if (items && typeof items === "object") {
+      return [exampleFromPropertySchema(items, "item")];
+    }
+    return [];
+  }
+  if (type === "object" || effective["properties"]) {
+    return exampleFromObjectSchema(effective);
+  }
+  return null;
+}
+
+// src/renderer/renderer.ts
+Handlebars.registerHelper("eq", (a3, b3) => a3 === b3);
+Handlebars.registerHelper("notEmpty", (obj) => {
+  if (!obj || typeof obj !== "object") return false;
+  return Object.keys(obj).length > 0;
+});
+Handlebars.registerHelper("inc", (val) => val + 1);
+Handlebars.registerHelper(
+  "lookupPayloadFields",
+  (schema) => {
+    const effective = resolveAllOf(schema ?? {});
+    const props = effective["properties"];
+    if (!props) return [];
+    const requiredSet = new Set(
+      effective["required"] ?? []
+    );
+    return Object.entries(props).map(([name, sub]) => {
+      const enumVals = sub["enum"];
+      return {
+        name,
+        type: sub["type"] ?? "any",
+        required: requiredSet.has(name),
+        enum: enumVals ? enumVals.join(" | ") : void 0
+      };
+    });
+  }
+);
+Handlebars.registerHelper("yamlBlock", (obj) => {
+  return toYamlString(obj);
+});
+Handlebars.registerHelper("jsonBlock", (obj) => {
+  return toJsonString(obj);
+});
+Handlebars.registerHelper("yamlFrontmatter", (obj) => {
+  return toYamlFrontmatter(obj);
 });
+Handlebars.registerHelper(
+  "handoffPayload",
+  (handoffType) => {
+    return resolveHandoffPayload(handoffType ?? void 0);
+  }
+);
+Handlebars.registerHelper(
+  "handoffEnvelope",
+  (handoffType, options) => {
+    const idOverride = typeof options?.hash?.id === "string" ? options.hash.id : void 0;
+    return buildHandoffEnvelope(handoffType ?? void 0, idOverride);
+  }
+);
 Handlebars.registerHelper(
   "join",
   (arr, separator) => {