@autohq/cli 0.1.247 → 0.1.248

package/dist/agent-bridge.js

@@ -23340,7 +23340,7 @@ Object.assign(lookup, {
 // package.json
 var package_default = {
   name: "@autohq/cli",
-  version: "0.1.247",
+  version: "0.1.248",
   license: "SEE LICENSE IN README.md",
   publishConfig: {
     access: "public"
@@ -27747,6 +27747,125 @@ var SessionCommandDispatchSignalPayloadSchema = external_exports.object({
 }).strict();
 var RealtimeRunCursorSchema = external_exports.string().regex(/^rt:(0|[1-9]\d*)$/);
 
+// ../../packages/schemas/src/templates/registry.ts
+function deriveLatestVersion(template) {
+  const [first, ...rest] = template.versions;
+  if (!first) {
+    throw new Error(`Managed template ${template.name} has no versions`);
+  }
+  return rest.reduce(
+    (latest, candidate) => compareSemver(candidate.version, latest.version) > 0 ? candidate : latest,
+    first
+  );
+}
+function compareSemver(left, right) {
+  const leftParts = left.split(".").map((part) => Number.parseInt(part, 10));
+  const rightParts = right.split(".").map((part) => Number.parseInt(part, 10));
+  const length = Math.max(leftParts.length, rightParts.length);
+  for (let index = 0; index < length; index += 1) {
+    const diff = (leftParts[index] ?? 0) - (rightParts[index] ?? 0);
+    if (diff !== 0) {
+      return diff < 0 ? -1 : 1;
+    }
+  }
+  return 0;
+}
+
+// ../../packages/schemas/src/templates/hardcoded.ts
+var ONBOARDING_FRAGMENT_V1 = [
+  "# Managed onboarding fragment (@auto/onboarding). Tenant onboarding agents",
+  "# import this to inherit Auto's house onboarding guidance. Tenant fields win",
+  "# on merge, so house tweaks can be layered on top of this base.",
+  "systemPrompt: |",
+  "  You are an Auto onboarding guide. Greet the user warmly, explain that Auto",
+  "  lets them compose agents and triggers into automated workflows from simple",
+  "  `.auto/` YAML, and guide them to their first deployed workflow. Keep replies",
+  "  short and conversational, ask one question at a time, and verify each step",
+  "  actually worked before telling the user it did."
+].join("\n");
+var MANAGED_TEMPLATES = [
+  {
+    name: "@auto/onboarding",
+    description: "Auto's house onboarding guidance, importable as a managed template.",
+    versions: [
+      {
+        version: "1.0.0",
+        files: [
+          {
+            path: "fragments/onboarding.yaml",
+            content: ONBOARDING_FRAGMENT_V1
+          }
+        ]
+      }
+    ]
+  }
+];
+var HardcodedTemplateRegistry = class {
+  templates;
+  constructor(templates = MANAGED_TEMPLATES) {
+    this.templates = new Map(
+      templates.map((template) => [template.name, template])
+    );
+  }
+  listTemplates() {
+    return [...this.templates.values()].map(toManagedTemplate);
+  }
+  getTemplate(name) {
+    const template = this.templates.get(name);
+    return template ? toManagedTemplate(template) : void 0;
+  }
+  resolveVersion(name, track) {
+    const template = this.requireTemplate(name);
+    if (track.kind === "pinned") {
+      return toTemplateVersion(this.requireVersion(template, track.version));
+    }
+    return deriveLatestVersion(toManagedTemplate(template));
+  }
+  getFiles(name, version2) {
+    return this.requireVersion(this.requireTemplate(name), version2).files.map(
+      toBundleFile
+    );
+  }
+  // ---------------------------------------------------------------------------
+  // Helpers
+  // ---------------------------------------------------------------------------
+  requireTemplate(name) {
+    const template = this.templates.get(name);
+    if (!template) {
+      throw new Error(`Unknown managed template ${name}`);
+    }
+    return template;
+  }
+  requireVersion(template, version2) {
+    const found = template.versions.find(
+      (candidate) => candidate.version === version2
+    );
+    if (!found) {
+      throw new Error(
+        `Managed template ${template.name} has no version ${version2}`
+      );
+    }
+    return found;
+  }
+};
+var defaultTemplateRegistry = new HardcodedTemplateRegistry();
+function toBundleFile(file2) {
+  return {
+    path: file2.path,
+    contentBase64: Buffer.from(file2.content, "utf8").toString("base64")
+  };
+}
+function toTemplateVersion(version2) {
+  return { version: version2.version, files: version2.files.map(toBundleFile) };
+}
+function toManagedTemplate(template) {
+  return {
+    name: template.name,
+    description: template.description,
+    versions: template.versions.map(toTemplateVersion)
+  };
+}
+
 // ../../packages/schemas/src/temporal.ts
 var ResourceReconciliationScopeSchema = external_exports.object({
   organizationId: external_exports.string().trim().min(1),

package/dist/index.js

@@ -19583,6 +19583,185 @@ var init_runtimes = __esm({
   }
 });
 
+// ../../packages/schemas/src/templates/types.ts
+var init_types = __esm({
+  "../../packages/schemas/src/templates/types.ts"() {
+    "use strict";
+  }
+});
+
+// ../../packages/schemas/src/templates/specifier.ts
+function isTemplateImportSpecifier(importPath) {
+  return importPath.startsWith("@");
+}
+function parseTemplateImportSpecifier(importPath) {
+  const match = SPECIFIER_PATTERN.exec(importPath);
+  if (!match) {
+    throw new Error(
+      `Invalid managed template import specifier: ${importPath}. Expected @scope/name[@version][/subpath].`
+    );
+  }
+  const [, scope, name, version2, subpath] = match;
+  return {
+    name: `@${scope}/${name}`,
+    track: version2 === void 0 || version2 === "latest" ? { kind: "latest" } : { kind: "pinned", version: version2 },
+    subpath: subpath ?? ""
+  };
+}
+function templateInjectionKey(name, subpath) {
+  return subpath ? `${TEMPLATE_INJECTION_PREFIX}/${name}/${subpath}` : `${TEMPLATE_INJECTION_PREFIX}/${name}`;
+}
+var TEMPLATE_INJECTION_PREFIX, SPECIFIER_PATTERN;
+var init_specifier = __esm({
+  "../../packages/schemas/src/templates/specifier.ts"() {
+    "use strict";
+    TEMPLATE_INJECTION_PREFIX = "packages";
+    SPECIFIER_PATTERN = /^@([^/@\s]+)\/([^/@\s]+)(?:@([^/\s]+))?(?:\/(.+))?$/;
+  }
+});
+
+// ../../packages/schemas/src/templates/registry.ts
+function deriveLatestVersion(template) {
+  const [first, ...rest] = template.versions;
+  if (!first) {
+    throw new Error(`Managed template ${template.name} has no versions`);
+  }
+  return rest.reduce(
+    (latest, candidate) => compareSemver(candidate.version, latest.version) > 0 ? candidate : latest,
+    first
+  );
+}
+function compareSemver(left, right) {
+  const leftParts = left.split(".").map((part) => Number.parseInt(part, 10));
+  const rightParts = right.split(".").map((part) => Number.parseInt(part, 10));
+  const length = Math.max(leftParts.length, rightParts.length);
+  for (let index = 0; index < length; index += 1) {
+    const diff = (leftParts[index] ?? 0) - (rightParts[index] ?? 0);
+    if (diff !== 0) {
+      return diff < 0 ? -1 : 1;
+    }
+  }
+  return 0;
+}
+var init_registry = __esm({
+  "../../packages/schemas/src/templates/registry.ts"() {
+    "use strict";
+  }
+});
+
+// ../../packages/schemas/src/templates/hardcoded.ts
+function toBundleFile(file2) {
+  return {
+    path: file2.path,
+    contentBase64: Buffer.from(file2.content, "utf8").toString("base64")
+  };
+}
+function toTemplateVersion(version2) {
+  return { version: version2.version, files: version2.files.map(toBundleFile) };
+}
+function toManagedTemplate(template) {
+  return {
+    name: template.name,
+    description: template.description,
+    versions: template.versions.map(toTemplateVersion)
+  };
+}
+var ONBOARDING_FRAGMENT_V1, MANAGED_TEMPLATES, HardcodedTemplateRegistry, defaultTemplateRegistry;
+var init_hardcoded = __esm({
+  "../../packages/schemas/src/templates/hardcoded.ts"() {
+    "use strict";
+    init_registry();
+    ONBOARDING_FRAGMENT_V1 = [
+      "# Managed onboarding fragment (@auto/onboarding). Tenant onboarding agents",
+      "# import this to inherit Auto's house onboarding guidance. Tenant fields win",
+      "# on merge, so house tweaks can be layered on top of this base.",
+      "systemPrompt: |",
+      "  You are an Auto onboarding guide. Greet the user warmly, explain that Auto",
+      "  lets them compose agents and triggers into automated workflows from simple",
+      "  `.auto/` YAML, and guide them to their first deployed workflow. Keep replies",
+      "  short and conversational, ask one question at a time, and verify each step",
+      "  actually worked before telling the user it did."
+    ].join("\n");
+    MANAGED_TEMPLATES = [
+      {
+        name: "@auto/onboarding",
+        description: "Auto's house onboarding guidance, importable as a managed template.",
+        versions: [
+          {
+            version: "1.0.0",
+            files: [
+              {
+                path: "fragments/onboarding.yaml",
+                content: ONBOARDING_FRAGMENT_V1
+              }
+            ]
+          }
+        ]
+      }
+    ];
+    HardcodedTemplateRegistry = class {
+      templates;
+      constructor(templates = MANAGED_TEMPLATES) {
+        this.templates = new Map(
+          templates.map((template) => [template.name, template])
+        );
+      }
+      listTemplates() {
+        return [...this.templates.values()].map(toManagedTemplate);
+      }
+      getTemplate(name) {
+        const template = this.templates.get(name);
+        return template ? toManagedTemplate(template) : void 0;
+      }
+      resolveVersion(name, track) {
+        const template = this.requireTemplate(name);
+        if (track.kind === "pinned") {
+          return toTemplateVersion(this.requireVersion(template, track.version));
+        }
+        return deriveLatestVersion(toManagedTemplate(template));
+      }
+      getFiles(name, version2) {
+        return this.requireVersion(this.requireTemplate(name), version2).files.map(
+          toBundleFile
+        );
+      }
+      // ---------------------------------------------------------------------------
+      // Helpers
+      // ---------------------------------------------------------------------------
+      requireTemplate(name) {
+        const template = this.templates.get(name);
+        if (!template) {
+          throw new Error(`Unknown managed template ${name}`);
+        }
+        return template;
+      }
+      requireVersion(template, version2) {
+        const found = template.versions.find(
+          (candidate) => candidate.version === version2
+        );
+        if (!found) {
+          throw new Error(
+            `Managed template ${template.name} has no version ${version2}`
+          );
+        }
+        return found;
+      }
+    };
+    defaultTemplateRegistry = new HardcodedTemplateRegistry();
+  }
+});
+
+// ../../packages/schemas/src/templates/index.ts
+var init_templates = __esm({
+  "../../packages/schemas/src/templates/index.ts"() {
+    "use strict";
+    init_types();
+    init_specifier();
+    init_registry();
+    init_hardcoded();
+  }
+});
+
 // ../../packages/schemas/src/temporal.ts
 var ResourceReconciliationScopeSchema;
 var init_temporal = __esm({
@@ -19686,6 +19865,7 @@ var init_src = __esm({
     init_runtimes();
     init_sessions();
     init_agents();
+    init_templates();
     init_temporal();
     init_tools();
     init_trigger_router();
@@ -22418,7 +22598,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@autohq/cli",
-      version: "0.1.247",
+      version: "0.1.248",
       license: "SEE LICENSE IN README.md",
       publishConfig: {
         access: "public"
@@ -23449,6 +23629,9 @@ function importPaths2(document) {
   });
 }
 function resolveImportPath2(importPath, importerPath, fileIndex) {
+  if (isTemplateImportSpecifier(importPath)) {
+    return resolveTemplateImportPath(importPath, fileIndex);
+  }
   if (isAbsoluteSourcePath(importPath) || /^[A-Za-z]+:\/\//.test(importPath)) {
     throw new Error(`Agent import must be a relative path: ${importPath}`);
   }
@@ -23462,6 +23645,21 @@ function resolveImportPath2(importPath, importerPath, fileIndex) {
   }
   return resolved;
 }
+function resolveTemplateImportPath(importPath, fileIndex) {
+  const specifier = parseTemplateImportSpecifier(importPath);
+  if (specifier.subpath === "") {
+    throw new Error(
+      `Managed template import must include a file subpath: ${importPath} (e.g. ${specifier.name}/fragments/runtime.yaml)`
+    );
+  }
+  const key = normalizeSourcePath(
+    templateInjectionKey(specifier.name, specifier.subpath)
+  );
+  if (!fileIndex.has(key)) {
+    throw new Error(`Agent import not found: ${importPath}`);
+  }
+  return key;
+}
 function removalDirectives2(document, path2) {
   const raw = isRecord2(document.remove) ? document.remove : {};
   const directives = [];
@@ -23485,6 +23683,7 @@ function stringList2(value, label) {
 var init_agent_document_merge = __esm({
   "../../packages/schemas/src/project-apply-files/agent-document-merge.ts"() {
     "use strict";
+    init_templates();
     init_source();
   }
 });
@@ -24281,6 +24480,77 @@ var init_assets = __esm({
   }
 });
 
+// ../../packages/schemas/src/project-apply-files/template-injection.ts
+function injectManagedTemplateFiles(input) {
+  const references = collectTemplateReferences(input.files);
+  if (references.size === 0) {
+    return input.files;
+  }
+  const present = new Set(
+    input.files.map((file2) => normalizeSourcePath(file2.path))
+  );
+  const injected = [];
+  for (const reference of references.values()) {
+    for (const file2 of resolveTemplateFiles(input.registry, reference)) {
+      const key = normalizeSourcePath(
+        templateInjectionKey(reference.name, normalizeSourcePath(file2.path))
+      );
+      if (present.has(key)) {
+        continue;
+      }
+      present.add(key);
+      injected.push({ path: key, contentBase64: file2.contentBase64 });
+    }
+  }
+  return injected.length === 0 ? input.files : [...input.files, ...injected];
+}
+function resolveTemplateFiles(registry2, reference) {
+  try {
+    const version2 = registry2.resolveVersion(reference.name, reference.track);
+    return registry2.getFiles(reference.name, version2.version);
+  } catch {
+    return [];
+  }
+}
+function collectTemplateReferences(files) {
+  const references = /* @__PURE__ */ new Map();
+  for (const file2 of files) {
+    for (const importPath of templateImportsInFile(file2)) {
+      const specifier = parseTemplateImportSpecifier(importPath);
+      if (!references.has(specifier.name)) {
+        references.set(specifier.name, specifier);
+      }
+    }
+  }
+  return references;
+}
+function templateImportsInFile(file2) {
+  try {
+    const specifiers = [];
+    for (const document of readDocumentsFromSource(file2)) {
+      if (!isRecord2(document)) {
+        continue;
+      }
+      for (const importPath of importPaths2(document)) {
+        if (isTemplateImportSpecifier(importPath)) {
+          specifiers.push(importPath);
+        }
+      }
+    }
+    return specifiers;
+  } catch {
+    return [];
+  }
+}
+var init_template_injection = __esm({
+  "../../packages/schemas/src/project-apply-files/template-injection.ts"() {
+    "use strict";
+    init_templates();
+    init_agent_document_merge();
+    init_source();
+  }
+});
+
 // ../../packages/schemas/src/project-apply-files/index.ts
 function readProjectApplyDirectorySource(input) {
   const resourceRoot = normalizeSourcePath(input.resourceRoot ?? "");
@@ -24431,6 +24701,7 @@ var init_project_apply_files = __esm({
     init_apply_result();
     init_assets();
     init_source();
+    init_template_injection();
   }
 });
 
@@ -24467,7 +24738,9 @@ function readProjectApplyBundleInput(options) {
     const file2 = resolve2(options.file);
     const projectRoot2 = applyFileProjectRoot(file2);
     const sourceRoot = applyFileSourceRoot(file2, projectRoot2);
-    const files2 = sourceFiles(sourceRoot, projectRoot2);
+    const files2 = withManagedTemplateFiles(
+      sourceFiles(sourceRoot, projectRoot2)
+    );
     const request = readProjectApplyFileSource({
       file: sourceFile(file2, projectRoot2),
       files: files2,
@@ -24486,7 +24759,7 @@ function readProjectApplyBundleInput(options) {
   }
   const directory = resolve2(options.directory ?? join7(process.cwd(), ".auto"));
   const projectRoot = applyProjectRoot(directory);
-  const files = sourceFiles(directory, projectRoot);
+  const files = withManagedTemplateFiles(sourceFiles(directory, projectRoot));
   const resourceRoot = sourcePathRelative(projectRoot, directory);
   return {
     request: readProjectApplyDirectorySource({
@@ -24507,6 +24780,12 @@ function readProjectApplyBundleInput(options) {
 function serializeProjectApplyBundle(bundle) {
   return JSON.stringify(ProjectApplyBundleSchema.parse(bundle));
 }
+function withManagedTemplateFiles(files) {
+  return injectManagedTemplateFiles({
+    files,
+    registry: defaultTemplateRegistry
+  });
+}
 function sourceFiles(root, projectRoot) {
   let entries;
   try {

package/package.json

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