@autohq/cli 0.1.280 → 0.1.281

package/dist/agent-bridge.js

@@ -23353,7 +23353,7 @@ Object.assign(lookup, {
 // package.json
 var package_default = {
   name: "@autohq/cli",
-  version: "0.1.280",
+  version: "0.1.281",
   license: "SEE LICENSE IN README.md",
   publishConfig: {
     access: "public"

package/dist/index.js

@@ -22999,7 +22999,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@autohq/cli",
-      version: "0.1.280",
+      version: "0.1.281",
       license: "SEE LICENSE IN README.md",
       publishConfig: {
         access: "public"
@@ -24183,7 +24183,12 @@ var init_helpers = __esm({
   "../../packages/schemas/src/project-apply-files/agent-fields/helpers.ts"() {
     "use strict";
     init_source();
-    CONTROL_FIELDS = /* @__PURE__ */ new Set(["import", "imports", "remove"]);
+    CONTROL_FIELDS = /* @__PURE__ */ new Set([
+      "import",
+      "imports",
+      "remove",
+      "variables"
+    ]);
     AGENT_METADATA_FIELD_KEYS = ["name", "labels", "annotations"];
   }
 });
@@ -24620,6 +24625,87 @@ var init_agent_fields = __esm({
   }
 });
 
+// ../../packages/schemas/src/project-apply-files/template-variables.ts
+function readVariableScope(document, path2) {
+  const declared = document[VARIABLE_DECLARATIONS_FIELD];
+  if (declared === void 0) {
+    return /* @__PURE__ */ new Map();
+  }
+  if (!isRecord2(declared)) {
+    throw new Error(
+      `Invalid variables in ${path2}: variables must be a map of name to value`
+    );
+  }
+  const scope = /* @__PURE__ */ new Map();
+  for (const [name, value] of Object.entries(declared)) {
+    if (!VARIABLE_NAME_PATTERN.test(name)) {
+      throw new Error(
+        `Invalid variable name "${name}" in ${path2}: names must match [A-Za-z_][A-Za-z0-9_]*`
+      );
+    }
+    scope.set(name, coerceVariableValue(name, value, path2));
+  }
+  return scope;
+}
+function substituteVariables(document, scope, site) {
+  if (scope.size === 0) {
+    return document;
+  }
+  return substituteValue(document, scope, site);
+}
+function substituteValue(value, scope, site) {
+  if (typeof value === "string") {
+    return substituteString(value, scope, site);
+  }
+  if (Array.isArray(value)) {
+    return value.map((item) => substituteValue(item, scope, site));
+  }
+  if (isRecord2(value)) {
+    return Object.fromEntries(
+      Object.entries(value).map(([key, nested]) => [
+        key,
+        substituteValue(nested, scope, site)
+      ])
+    );
+  }
+  return value;
+}
+function substituteString(value, scope, site) {
+  return value.replace(VARIABLE_REFERENCE_PATTERN, (_match, name) => {
+    const resolved = scope.get(name);
+    if (resolved === void 0) {
+      throw new Error(
+        `Unresolved variable "{{ $${name} }}" in imported ${site.importPath}: declare it in the importing agent's variables (available: ${availableNames(scope)}).`
+      );
+    }
+    return resolved;
+  });
+}
+function coerceVariableValue(name, value, path2) {
+  if (typeof value === "string") {
+    return value;
+  }
+  if (typeof value === "number" || typeof value === "boolean") {
+    return String(value);
+  }
+  throw new Error(
+    `Invalid value for variable "${name}" in ${path2}: variable values must be a string, number, or boolean`
+  );
+}
+function availableNames(scope) {
+  return [...scope.keys()].sort().map((name) => `{{ $${name} }}`).join(", ");
+}
+var VARIABLE_DECLARATIONS_FIELD, VARIABLE_NAME_PATTERN, VARIABLE_REFERENCE_PATTERN;
+var init_template_variables = __esm({
+  "../../packages/schemas/src/project-apply-files/template-variables.ts"() {
+    "use strict";
+    init_source();
+    VARIABLE_DECLARATIONS_FIELD = "variables";
+    VARIABLE_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
+    VARIABLE_REFERENCE_PATTERN = /\{\{\s*\$([A-Za-z_][A-Za-z0-9_]*)\s*\}\}/g;
+  }
+});
+
 // ../../packages/schemas/src/project-apply-files/agent-authoring.ts
 function readApplyDocument(path2, document, fileIndex) {
   assertAgentAuthoringDocument(document, path2);
@@ -24647,7 +24733,8 @@ function validateAgentFragmentDocument(document, path2, context) {
       imported,
       {
         fileIndex: context.fileIndex,
-        stack: [...context.stack, normalizedPath]
+        stack: [...context.stack, normalizedPath],
+        variables: context.variables
       }
     );
   }
@@ -24684,7 +24771,8 @@ function compileAgentDocumentValue(document, path2, fileIndex) {
   return compileAgentDraftResources(
     compileAgentDocument2(document, path2, {
       fileIndex,
-      stack: []
+      stack: [],
+      variables: /* @__PURE__ */ new Map()
     }),
     path2
   );
@@ -24699,20 +24787,26 @@ function compileAgentDocument2(document, path2, context) {
   if (!isRecord2(document)) {
     throw new Error(`Invalid agent authoring file ${path2}: expected object`);
   }
+  const variables = context.stack.length === 0 ? readVariableScope(document, normalizedPath) : context.variables;
   let merged = emptyAgentDraft();
-  for (const imported of importPaths2(document).map(
-    (importPath) => resolveImportPath2(importPath, normalizedPath, context.fileIndex)
-  )) {
+  for (const importPath of importPaths2(document)) {
+    const imported = resolveImportPath2(
+      importPath,
+      normalizedPath,
+      context.fileIndex
+    );
+    const importedDocument = substituteVariables(
+      readSingleDocument2(imported, context.fileIndex),
+      variables,
+      { importPath }
+    );
     merged = mergeAgentDrafts(
       merged,
-      compileAgentDocument2(
-        readSingleDocument2(imported, context.fileIndex),
-        imported,
-        {
-          fileIndex: context.fileIndex,
-          stack: [...context.stack, normalizedPath]
-        }
-      )
+      compileAgentDocument2(importedDocument, imported, {
+        fileIndex: context.fileIndex,
+        stack: [...context.stack, normalizedPath],
+        variables
+      })
     );
   }
   for (const removal of removalDirectives2(document, normalizedPath)) {
@@ -24729,6 +24823,7 @@ var init_agent_authoring = __esm({
     init_agent_document_merge();
     init_agent_fields();
     init_source();
+    init_template_variables();
   }
 });
 
@@ -25116,7 +25211,8 @@ function assertValidFragmentSourceFiles(files, resourceRoot, fileIndex) {
       }
       validateAgentFragmentDocument(documents[0], file2.path, {
         fileIndex,
-        stack: []
+        stack: [],
+        variables: /* @__PURE__ */ new Map()
       });
     } catch (error51) {
       throw new Error(
@@ -25142,6 +25238,7 @@ var init_project_apply_files = __esm({
     init_template_injection();
     init_template_bump_diagnostics();
     init_template_staleness();
+    init_template_variables();
   }
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autohq/cli",
-  "version": "0.1.280",
+  "version": "0.1.281",
   "license": "SEE LICENSE IN README.md",
   "publishConfig": {
     "access": "public"