agent-contracts 0.12.0 → 0.12.2

package/dist/index.d.ts

@@ -130,10 +130,21 @@ declare const BindingOutputSchema: z.ZodObject<{
     target: z.ZodString;
     template: z.ZodOptional<z.ZodString>;
     inline_template: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodString>;
     mode: z.ZodDefault<z.ZodEnum<{
         write: "write";
         patch: "patch";
     }>>;
+    format: z.ZodOptional<z.ZodEnum<{
+        json: "json";
+        yaml: "yaml";
+        text: "text";
+    }>>;
+    patch_strategy: z.ZodOptional<z.ZodEnum<{
+        deep_merge: "deep_merge";
+        append: "append";
+    }>>;
+    array_merge_key: z.ZodOptional<z.ZodString>;
     group_by: z.ZodOptional<z.ZodString>;
     executable: z.ZodOptional<z.ZodBoolean>;
     skip_empty: z.ZodOptional<z.ZodBoolean>;
@@ -172,10 +183,21 @@ declare const SoftwareBindingSchema: z.ZodObject<{
         target: z.ZodString;
         template: z.ZodOptional<z.ZodString>;
         inline_template: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodString>;
         mode: z.ZodDefault<z.ZodEnum<{
             write: "write";
             patch: "patch";
         }>>;
+        format: z.ZodOptional<z.ZodEnum<{
+            json: "json";
+            yaml: "yaml";
+            text: "text";
+        }>>;
+        patch_strategy: z.ZodOptional<z.ZodEnum<{
+            deep_merge: "deep_merge";
+            append: "append";
+        }>>;
+        array_merge_key: z.ZodOptional<z.ZodString>;
         group_by: z.ZodOptional<z.ZodString>;
         executable: z.ZodOptional<z.ZodBoolean>;
         skip_empty: z.ZodOptional<z.ZodBoolean>;

package/dist/index.js

@@ -2242,7 +2242,7 @@ var require_lodash = __commonJS({
               } else {
                 newValue = [];
               }
-            } else if (isPlainObject(srcValue) || isArguments(srcValue)) {
+            } else if (isPlainObject2(srcValue) || isArguments(srcValue)) {
               newValue = objValue;
               if (isArguments(objValue)) {
                 newValue = toPlainObject(objValue);
@@ -3206,7 +3206,7 @@ var require_lodash = __commonJS({
           return objValue;
         }
         function customOmitClone(value) {
-          return isPlainObject(value) ? undefined2 : value;
+          return isPlainObject2(value) ? undefined2 : value;
         }
         function equalArrays(array, other, bitmask, customizer, equalFunc, stack) {
           var isPartial = bitmask & COMPARE_PARTIAL_FLAG, arrLength = array.length, othLength = other.length;
@@ -4707,7 +4707,7 @@ var require_lodash = __commonJS({
         var isBuffer = nativeIsBuffer || stubFalse;
         var isDate = nodeIsDate ? baseUnary(nodeIsDate) : baseIsDate;
         function isElement(value) {
-          return isObjectLike(value) && value.nodeType === 1 && !isPlainObject(value);
+          return isObjectLike(value) && value.nodeType === 1 && !isPlainObject2(value);
         }
         function isEmpty(value) {
           if (value == null) {
@@ -4743,7 +4743,7 @@ var require_lodash = __commonJS({
             return false;
           }
           var tag = baseGetTag(value);
-          return tag == errorTag || tag == domExcTag || typeof value.message == "string" && typeof value.name == "string" && !isPlainObject(value);
+          return tag == errorTag || tag == domExcTag || typeof value.message == "string" && typeof value.name == "string" && !isPlainObject2(value);
         }
         function isFinite2(value) {
           return typeof value == "number" && nativeIsFinite(value);
@@ -4794,7 +4794,7 @@ var require_lodash = __commonJS({
         function isNumber(value) {
           return typeof value == "number" || isObjectLike(value) && baseGetTag(value) == numberTag;
         }
-        function isPlainObject(value) {
+        function isPlainObject2(value) {
           if (!isObjectLike(value) || baseGetTag(value) != objectTag) {
             return false;
           }
@@ -5865,7 +5865,7 @@ var require_lodash = __commonJS({
         lodash.isNumber = isNumber;
         lodash.isObject = isObject2;
         lodash.isObjectLike = isObjectLike;
-        lodash.isPlainObject = isPlainObject;
+        lodash.isPlainObject = isPlainObject2;
         lodash.isRegExp = isRegExp;
         lodash.isSafeInteger = isSafeInteger;
         lodash.isSet = isSet;
@@ -17505,10 +17505,10 @@ var require_immer_cjs_development = __commonJS({
     function isDraftable(value) {
       var _value$constructor;
       if (!value) return false;
-      return isPlainObject(value) || Array.isArray(value) || !!value[DRAFTABLE] || !!((_value$constructor = value.constructor) === null || _value$constructor === void 0 ? void 0 : _value$constructor[DRAFTABLE]) || isMap(value) || isSet(value);
+      return isPlainObject2(value) || Array.isArray(value) || !!value[DRAFTABLE] || !!((_value$constructor = value.constructor) === null || _value$constructor === void 0 ? void 0 : _value$constructor[DRAFTABLE]) || isMap(value) || isSet(value);
     }
     var objectCtorString = /* @__PURE__ */ Object.prototype.constructor.toString();
-    function isPlainObject(value) {
+    function isPlainObject2(value) {
       if (!value || typeof value !== "object") return false;
       var proto = Object.getPrototypeOf(value);
       if (proto === null) {
@@ -40191,10 +40191,10 @@ var require_object_inspect = __commonJS({
       }
       if (!isDate(obj) && !isRegExp(obj)) {
         var ys = arrObjKeys(obj, inspect);
-        var isPlainObject = gPO ? gPO(obj) === Object.prototype : obj instanceof Object || obj.constructor === Object;
+        var isPlainObject2 = gPO ? gPO(obj) === Object.prototype : obj instanceof Object || obj.constructor === Object;
         var protoTag = obj instanceof Object ? "" : "null prototype";
-        var stringTag = !isPlainObject && toStringTag2 && Object(obj) === obj && toStringTag2 in obj ? $slice.call(toStr(obj), 8, -1) : protoTag ? "Object" : "";
-        var constructorTag = isPlainObject || typeof obj.constructor !== "function" ? "" : obj.constructor.name ? obj.constructor.name + " " : "";
+        var stringTag = !isPlainObject2 && toStringTag2 && Object(obj) === obj && toStringTag2 in obj ? $slice.call(toStr(obj), 8, -1) : protoTag ? "Object" : "";
+        var constructorTag = isPlainObject2 || typeof obj.constructor !== "function" ? "" : obj.constructor.name ? obj.constructor.name + " " : "";
         var tag = constructorTag + (stringTag || protoTag ? "[" + $join.call($concat.call([], stringTag || [], protoTag || []), ": ") + "] " : "");
         if (ys.length === 0) {
           return tag + "{}";
@@ -44529,7 +44529,7 @@ var require_lodash3 = __commonJS({
               } else {
                 newValue = [];
               }
-            } else if (isPlainObject(srcValue) || isArguments(srcValue)) {
+            } else if (isPlainObject2(srcValue) || isArguments(srcValue)) {
               newValue = objValue;
               if (isArguments(objValue)) {
                 newValue = toPlainObject(objValue);
@@ -45500,7 +45500,7 @@ var require_lodash3 = __commonJS({
           return objValue;
         }
         function customOmitClone(value) {
-          return isPlainObject(value) ? undefined2 : value;
+          return isPlainObject2(value) ? undefined2 : value;
         }
         function equalArrays(array, other, bitmask, customizer, equalFunc, stack) {
           var isPartial = bitmask & COMPARE_PARTIAL_FLAG, arrLength = array.length, othLength = other.length;
@@ -47001,7 +47001,7 @@ var require_lodash3 = __commonJS({
         var isBuffer = nativeIsBuffer || stubFalse;
         var isDate = nodeIsDate ? baseUnary(nodeIsDate) : baseIsDate;
         function isElement(value) {
-          return isObjectLike(value) && value.nodeType === 1 && !isPlainObject(value);
+          return isObjectLike(value) && value.nodeType === 1 && !isPlainObject2(value);
         }
         function isEmpty(value) {
           if (value == null) {
@@ -47037,7 +47037,7 @@ var require_lodash3 = __commonJS({
             return false;
           }
           var tag = baseGetTag(value);
-          return tag == errorTag || tag == domExcTag || typeof value.message == "string" && typeof value.name == "string" && !isPlainObject(value);
+          return tag == errorTag || tag == domExcTag || typeof value.message == "string" && typeof value.name == "string" && !isPlainObject2(value);
         }
         function isFinite2(value) {
           return typeof value == "number" && nativeIsFinite(value);
@@ -47088,7 +47088,7 @@ var require_lodash3 = __commonJS({
         function isNumber(value) {
           return typeof value == "number" || isObjectLike(value) && baseGetTag(value) == numberTag;
         }
-        function isPlainObject(value) {
+        function isPlainObject2(value) {
           if (!isObjectLike(value) || baseGetTag(value) != objectTag) {
             return false;
           }
@@ -48154,7 +48154,7 @@ var require_lodash3 = __commonJS({
         lodash.isNumber = isNumber;
         lodash.isObject = isObject2;
         lodash.isObjectLike = isObjectLike;
-        lodash.isPlainObject = isPlainObject;
+        lodash.isPlainObject = isPlainObject2;
         lodash.isRegExp = isRegExp;
         lodash.isSafeInteger = isSafeInteger;
         lodash.isSet = isSet;
@@ -50511,13 +50511,20 @@ var BindingOutputSchema = z3.object({
   target: z3.string(),
   template: z3.string().optional(),
   inline_template: z3.string().optional(),
+  source: z3.string().optional(),
   mode: z3.enum(["write", "patch"]).default("write"),
+  format: z3.enum(["json", "yaml", "text"]).optional(),
+  patch_strategy: z3.enum(["deep_merge", "append"]).optional(),
+  array_merge_key: z3.string().optional(),
   group_by: z3.string().optional(),
   executable: z3.boolean().optional(),
   skip_empty: z3.boolean().optional()
 }).passthrough().refine(
-  (data) => !(data.template && data.inline_template),
-  { message: "template and inline_template are mutually exclusive" }
+  (data) => {
+    const count = [data.template, data.inline_template, data.source].filter(Boolean).length;
+    return count === 1 || count === 0;
+  },
+  { message: "Only one of template, inline_template, or source may be specified" }
 );
 var ReportingSchema = z3.object({
   commands: z3.record(z3.string(), z3.string()),
@@ -54961,9 +54968,10 @@ function score(dsl) {
 }
 
 // src/guardrail-generator/generator.ts
-import { readFile as readFile5, writeFile as writeFile2, mkdir as mkdir2, chmod, unlink as unlink2 } from "fs/promises";
+import { readFile as readFile5, writeFile as writeFile2, mkdir as mkdir2, chmod, unlink as unlink2, copyFile } from "fs/promises";
 import { resolve as resolve6, dirname as dirname6 } from "path";
 import Handlebars2 from "handlebars";
+import YAML from "yaml";
 
 // src/guardrail-generator/resolve-checks.ts
 function resolveChecks(dsl, binding, policy) {
@@ -55035,6 +55043,81 @@ Handlebars2.registerHelper(
     return new Handlebars2.SafeString(result);
   }
 );
+function isPlainObject(val) {
+  return typeof val === "object" && val !== null && !Array.isArray(val);
+}
+function deepMergeArrays(existing, incoming, mergeKey) {
+  if (!mergeKey) return [...existing, ...incoming];
+  const merged = [...existing];
+  for (const item of incoming) {
+    if (isPlainObject(item) && mergeKey in item) {
+      const idx = merged.findIndex(
+        (e3) => isPlainObject(e3) && e3[mergeKey] === item[mergeKey]
+      );
+      if (idx >= 0) {
+        merged[idx] = item;
+      } else {
+        merged.push(item);
+      }
+    } else {
+      merged.push(item);
+    }
+  }
+  return merged;
+}
+function deepMerge(existing, incoming, arrayMergeKey) {
+  if (Array.isArray(existing) && Array.isArray(incoming)) {
+    return deepMergeArrays(existing, incoming, arrayMergeKey);
+  }
+  if (isPlainObject(existing) && isPlainObject(incoming)) {
+    const result = { ...existing };
+    for (const [key, val] of Object.entries(incoming)) {
+      result[key] = key in result ? deepMerge(result[key], val, arrayMergeKey) : val;
+    }
+    return result;
+  }
+  return incoming;
+}
+function parseContent(raw, format2) {
+  if (format2 === "json") return JSON.parse(raw);
+  if (format2 === "yaml") return YAML.parse(raw);
+  throw new Error(`Unsupported format for patch parsing: ${format2}`);
+}
+function serializeContent(data, format2) {
+  if (format2 === "json") return JSON.stringify(data, null, 2) + "\n";
+  if (format2 === "yaml") return YAML.stringify(data);
+  throw new Error(`Unsupported format for patch serialization: ${format2}`);
+}
+async function applyPatch(targetPath, patchContent, outputDef) {
+  const format2 = outputDef.format ?? "json";
+  if (format2 === "text") {
+    let existing = "";
+    try {
+      existing = await readFile5(targetPath, "utf8");
+    } catch {
+    }
+    return existing + patchContent;
+  }
+  const patchData = parseContent(patchContent, format2);
+  let existingData;
+  try {
+    const existingRaw = await readFile5(targetPath, "utf8");
+    existingData = parseContent(existingRaw, format2);
+  } catch {
+    return serializeContent(patchData, format2);
+  }
+  const strategy = outputDef.patch_strategy ?? "deep_merge";
+  if (strategy === "append" && Array.isArray(existingData)) {
+    const merged2 = deepMergeArrays(
+      existingData,
+      Array.isArray(patchData) ? patchData : [patchData],
+      outputDef.array_merge_key
+    );
+    return serializeContent(merged2, format2);
+  }
+  const merged = deepMerge(existingData, patchData, outputDef.array_merge_key);
+  return serializeContent(merged, format2);
+}
 async function generateGuardrails(options) {
   const { dsl, config, loadedBindings, filterBindings, dryRun } = options;
   const outputFiles = [];
@@ -55104,6 +55187,31 @@ async function generateGuardrails(options) {
         continue;
       }
       const targetPath = resolve6(config.configDir, pathResult.resolved);
+      if (outputDef.source) {
+        const sourcePath = resolve6(config.configDir, outputDef.source);
+        if (!dryRun) {
+          try {
+            await mkdir2(dirname6(targetPath), { recursive: true });
+            await copyFile(sourcePath, targetPath);
+            if (outputDef.executable) {
+              await chmod(targetPath, 493);
+            }
+          } catch (err) {
+            const code = err.code;
+            if (code === "ENOENT") {
+              diagnostics.push({
+                path: `binding.${binding.software}.outputs.${outputId}`,
+                message: `Source file not found: ${sourcePath}`,
+                severity: "error"
+              });
+              continue;
+            }
+            throw err;
+          }
+        }
+        outputFiles.push(targetPath);
+        continue;
+      }
       let templateContent;
       if (outputDef.inline_template) {
         templateContent = outputDef.inline_template;
@@ -55130,12 +55238,13 @@ async function generateGuardrails(options) {
       } else {
         diagnostics.push({
           path: `binding.${binding.software}.outputs.${outputId}`,
-          message: "Output has neither template nor inline_template",
+          message: "Output has neither template, inline_template, nor source",
           severity: "error"
         });
         continue;
       }
       const shouldSkipEmpty = outputDef.skip_empty === true;
+      const isPatch = outputDef.mode === "patch";
       if (outputDef.group_by) {
         const groupField = outputDef.group_by;
         const groups = /* @__PURE__ */ new Map();
@@ -55153,9 +55262,9 @@ async function generateGuardrails(options) {
             current_group: groupKey
           };
           const compiled = Handlebars2.compile(templateContent, { noEscape: true });
-          const output = compiled(groupCtx);
+          const rendered = compiled(groupCtx);
           const groupTarget = resolve6(targetPath, groupKey);
-          if (shouldSkipEmpty && output.trim().length === 0) {
+          if (shouldSkipEmpty && rendered.trim().length === 0) {
             if (!dryRun) {
               try {
                 await unlink2(groupTarget);
@@ -55164,6 +55273,7 @@ async function generateGuardrails(options) {
             }
             continue;
           }
+          const output = isPatch && !dryRun ? await applyPatch(groupTarget, rendered, outputDef) : rendered;
           if (!dryRun) {
             await mkdir2(dirname6(groupTarget), { recursive: true });
             await writeFile2(groupTarget, output, "utf8");
@@ -55175,8 +55285,8 @@ async function generateGuardrails(options) {
         }
       } else {
         const compiled = Handlebars2.compile(templateContent, { noEscape: true });
-        const output = compiled(ctx);
-        if (shouldSkipEmpty && output.trim().length === 0) {
+        const rendered = compiled(ctx);
+        if (shouldSkipEmpty && rendered.trim().length === 0) {
           if (!dryRun) {
             try {
               await unlink2(targetPath);
@@ -55184,6 +55294,7 @@ async function generateGuardrails(options) {
             }
           }
         } else {
+          const output = isPatch && !dryRun ? await applyPatch(targetPath, rendered, outputDef) : rendered;
           if (!dryRun) {
             await mkdir2(dirname6(targetPath), { recursive: true });
             await writeFile2(targetPath, output, "utf8");