@autohq/cli 0.1.676 → 0.1.678

package/dist/agent-bridge.js

@@ -33217,7 +33217,7 @@ function bootstrapAdditionalData(input) {
 // package.json
 var package_default = {
   name: "@autohq/cli",
-  version: "0.1.676",
+  version: "0.1.678",
   license: "SEE LICENSE IN README.md",
   publishConfig: {
     access: "public"

package/dist/index.js

@@ -23403,6 +23403,21 @@ var init_validation_diagnostics = __esm({
         message: "The Auto authoring file could not be parsed as YAML or JSON.",
         owner: "schemas/project-apply-files"
       },
+      "auto.validation.schema_version.invalid": {
+        severity: "error",
+        message: "The authored schema version must be a positive integer.",
+        owner: "schemas/project-apply-files"
+      },
+      "auto.validation.schema_version.unsupported": {
+        severity: "error",
+        message: "This Auto release does not support the authored schema version.",
+        owner: "schemas/project-apply-files"
+      },
+      "auto.validation.authoring.unknown_field": {
+        severity: "error",
+        message: "The versioned authoring document contains an unknown field.",
+        owner: "schemas/project-apply-files"
+      },
       "auto.validation.schema.invalid": {
         severity: "error",
         message: "The Auto resource does not match its schema.",
@@ -23429,7 +23444,8 @@ var init_validation_diagnostics = __esm({
       location: external_exports.object({
         file: external_exports.string().min(1),
         line: external_exports.number().int().positive().optional(),
-        column: external_exports.number().int().positive().optional()
+        column: external_exports.number().int().positive().optional(),
+        documentIndex: external_exports.number().int().nonnegative().optional()
       }).optional(),
       remediation: external_exports.object({
         summary: external_exports.string().min(1),
@@ -24918,7 +24934,7 @@ var init_session_inbox = __esm({
 });
 
 // ../../packages/schemas/src/session-do-command-queue.ts
-var SessionDoCommandEnqueueRequestSchema, SessionDoCommandProjectionSchema, SessionDoCommandEnqueueReceiptSchema, SessionCommandMutationResponseSchema, SessionInboxMutationResponseSchema, SessionInboxSteerMutationResponseSchema;
+var SessionDoCommandEnqueueRequestSchema, SessionDoCommandProjectionSchema, SessionDoInboxReadResponseSchema, SessionDoCommandEnqueueReceiptSchema, SessionCommandMutationResponseSchema, SessionInboxMutationResponseSchema, SessionInboxSteerMutationResponseSchema;
 var init_session_do_command_queue = __esm({
   "../../packages/schemas/src/session-do-command-queue.ts"() {
     "use strict";
@@ -24932,10 +24948,19 @@ var init_session_do_command_queue = __esm({
       kind: SessionCommandKindSchema
     });
     SessionDoCommandProjectionSchema = external_exports.object({
+      // Optional for responses from a draining pre-epoch SessionDO deployment.
+      // A new SessionDO always includes its durable epoch.
+      epoch: external_exports.string().trim().min(1).max(200).optional(),
       revision: external_exports.number().int().nonnegative().safe(),
       inbox: external_exports.array(SessionInboxItemSchema),
       ledgerItem: SessionLedgerItemRecordSchema.nullable()
     });
+    SessionDoInboxReadResponseSchema = external_exports.object({
+      type: external_exports.literal("session_do.inbox"),
+      epoch: external_exports.string().trim().min(1).max(200),
+      revision: external_exports.number().int().nonnegative().safe(),
+      items: external_exports.array(SessionInboxItemSchema)
+    });
     SessionDoCommandEnqueueReceiptSchema = external_exports.object({
       type: external_exports.literal("session_do.command.enqueued"),
       commandId: SessionCommandIdSchema,
@@ -25213,11 +25238,34 @@ var init_session_ledger_stream = __esm({
     });
     SessionInboxEventSchema = external_exports.object({
       type: external_exports.literal("inbox"),
+      // Optional while older SessionDO deployments drain. Once present, the
+      // epoch lets a client adopt a legitimate SessionDO storage reset even when
+      // the new object's revision is lower than the last revision it observed.
+      epoch: external_exports.string().trim().min(1).max(200).optional(),
+      // Present only on the freshly read reconnect projection. Live
+      // publications and command receipts omit it, so delayed work from an
+      // unseen prior epoch cannot switch a client back after this fence.
+      snapshot: external_exports.literal(true).optional(),
       // Optional while older SessionDO deployments drain. New publishers attach
       // their durable monotonic projection revision so delayed events and command
       // responses cannot regress the client inbox.
       revision: external_exports.number().int().nonnegative().safe().optional(),
       items: external_exports.array(SessionInboxItemSchema)
+    }).superRefine((event, context) => {
+      if (event.epoch !== void 0 && event.revision === void 0) {
+        context.addIssue({
+          code: "custom",
+          path: ["revision"],
+          message: "An epoch inbox event must include its revision"
+        });
+      }
+      if (event.snapshot && event.epoch === void 0) {
+        context.addIssue({
+          code: "custom",
+          path: ["epoch"],
+          message: "An inbox snapshot must include its epoch"
+        });
+      }
     });
     SessionLedgerStreamEventSchema = external_exports.discriminatedUnion("type", [
       SessionLedgerItemEventSchema,
@@ -104503,7 +104551,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@autohq/cli",
-      version: "0.1.676",
+      version: "0.1.678",
       license: "SEE LICENSE IN README.md",
       publishConfig: {
         access: "public"
@@ -105507,17 +105555,140 @@ var init_agent_tool_connect = __esm({
   }
 });
 
+// ../../packages/schemas/src/project-apply-files/schema-version.ts
+function selectAuthoredSchemaDocument(input) {
+  if (!isRecord4(input.document) || !Object.hasOwn(input.document, "schemaVersion")) {
+    return {
+      dialect: LEGACY_AUTHORED_SCHEMA_DIALECT,
+      value: input.document
+    };
+  }
+  const version2 = input.document.schemaVersion;
+  if (typeof version2 !== "number" || !isPositiveInteger(version2)) {
+    throw malformedSchemaVersionError(input);
+  }
+  if (version2 > CURRENT_AUTHORED_SCHEMA_VERSION) {
+    throw unsupportedSchemaVersionError(input, version2);
+  }
+  const { schemaVersion: _controlField, ...body } = input.document;
+  return {
+    dialect: CURRENT_AUTHORED_SCHEMA_DIALECT,
+    value: migrateAuthoredSchemaDocument({
+      document: body,
+      fromVersion: version2,
+      toVersion: CURRENT_AUTHORED_SCHEMA_VERSION,
+      migrations: AUTHORED_SCHEMA_MIGRATIONS
+    })
+  };
+}
+function isAuthoredSchemaVersionError(error51) {
+  if (!(error51 instanceof AutoValidationDiagnosticError)) {
+    return false;
+  }
+  return error51.diagnostic.code === "auto.validation.schema_version.invalid" || error51.diagnostic.code === "auto.validation.schema_version.unsupported";
+}
+function migrateAuthoredSchemaDocument(input) {
+  if (!isPositiveInteger(input.fromVersion) || !isPositiveInteger(input.toVersion)) {
+    throw new Error(
+      "Authored schema migration endpoints must be positive integers"
+    );
+  }
+  if (input.fromVersion > input.toVersion) {
+    throw new Error(
+      `Authored schema migrations cannot move backward from ${input.fromVersion} to ${input.toVersion}`
+    );
+  }
+  let document = structuredClone(input.document);
+  for (let version2 = input.fromVersion; version2 < input.toVersion; version2 += 1) {
+    const edges = input.migrations.filter(
+      (edge) => edge.fromVersion === version2
+    );
+    if (edges.length !== 1 || edges[0]?.toVersion !== version2 + 1) {
+      throw new Error(
+        `Authored schema migration chain requires exactly one ${version2} -> ${version2 + 1} edge`
+      );
+    }
+    document = edges[0].migrate(structuredClone(document));
+  }
+  return document;
+}
+function malformedSchemaVersionError(input) {
+  return new AutoValidationDiagnosticError(
+    `Invalid schemaVersion in ${documentLabel(input)}: expected a positive integer`,
+    autoValidationDiagnostic({
+      code: "auto.validation.schema_version.invalid",
+      path: ["schemaVersion"],
+      location: diagnosticLocation(input),
+      remediation: {
+        summary: `Set schemaVersion to ${CURRENT_AUTHORED_SCHEMA_VERSION}, or remove it to retain the legacy dialect.`
+      }
+    })
+  );
+}
+function unsupportedSchemaVersionError(input, version2) {
+  return new AutoValidationDiagnosticError(
+    `Unsupported schemaVersion ${version2} in ${documentLabel(input)}: this Auto release supports through ${CURRENT_AUTHORED_SCHEMA_VERSION}`,
+    autoValidationDiagnostic({
+      code: "auto.validation.schema_version.unsupported",
+      path: ["schemaVersion"],
+      location: diagnosticLocation(input),
+      remediation: {
+        summary: "Upgrade Auto to a release that supports this authored schema version, then validate again."
+      }
+    })
+  );
+}
+function documentLabel(input) {
+  return `${input.location.file} document ${input.documentIndex + 1}`;
+}
+function diagnosticLocation(input) {
+  return {
+    ...input.topLevelLocations.schemaVersion ?? input.location,
+    documentIndex: input.documentIndex
+  };
+}
+function isRecord4(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isPositiveInteger(value) {
+  return Number.isInteger(value) && value > 0;
+}
+var CURRENT_AUTHORED_SCHEMA_VERSION, LEGACY_AUTHORED_SCHEMA_DIALECT, AUTHORED_SCHEMA_MIGRATIONS, CURRENT_AUTHORED_SCHEMA_DIALECT;
+var init_schema_version = __esm({
+  "../../packages/schemas/src/project-apply-files/schema-version.ts"() {
+    "use strict";
+    init_validation_diagnostics();
+    CURRENT_AUTHORED_SCHEMA_VERSION = 1;
+    LEGACY_AUTHORED_SCHEMA_DIALECT = Object.freeze({
+      kind: "legacy"
+    });
+    AUTHORED_SCHEMA_MIGRATIONS = Object.freeze([]);
+    CURRENT_AUTHORED_SCHEMA_DIALECT = Object.freeze({
+      kind: "versioned",
+      version: CURRENT_AUTHORED_SCHEMA_VERSION
+    });
+  }
+});
+
 // ../../packages/schemas/src/project-apply-files/source.ts
-import { parseAllDocuments as parseYamlDocuments2 } from "yaml";
-function readDocumentsFromSource(file2) {
+import {
+  LineCounter,
+  isMap,
+  parseAllDocuments as parseYamlDocuments2
+} from "yaml";
+function readSourceDocuments(file2) {
   const source = Buffer.from(file2.contentBase64, "base64").toString("utf8");
+  const lineCounter = new LineCounter();
+  let parsedDocuments;
   try {
-    const parsedDocuments = parseYamlDocuments2(source);
+    parsedDocuments = parseYamlDocuments2(source, {
+      keepSourceTokens: true,
+      lineCounter
+    });
     const parseError = parsedDocuments.flatMap((document) => document.errors).at(0);
     if (parseError) {
       throw parseError;
     }
-    return parsedDocuments.filter((document) => document.contents !== null).map((document) => document.toJSON());
   } catch {
     throw new AutoValidationDiagnosticError(
       `Invalid apply file ${file2.path}: YAML or JSON could not be parsed`,
@@ -105530,6 +105701,55 @@ function readDocumentsFromSource(file2) {
       })
     );
   }
+  return parsedDocuments.flatMap((document, documentIndex) => {
+    if (document.contents === null) {
+      return [];
+    }
+    const value = sourceDocumentValue(document, file2.path);
+    const location = sourceNodeLocation(
+      document.contents,
+      file2.path,
+      lineCounter
+    );
+    const topLevelLocations = topLevelSourceLocations(
+      document.contents,
+      file2.path,
+      lineCounter
+    );
+    const selected = selectAuthoredSchemaDocument({
+      document: value,
+      documentIndex,
+      location,
+      topLevelLocations
+    });
+    return [
+      {
+        ...selected,
+        documentIndex,
+        location,
+        topLevelLocations
+      }
+    ];
+  });
+}
+function sourceDocumentValue(document, file2) {
+  try {
+    return document.toJSON();
+  } catch {
+    throw invalidSourceSyntaxError(file2);
+  }
+}
+function invalidSourceSyntaxError(file2) {
+  return new AutoValidationDiagnosticError(
+    `Invalid apply file ${file2}: YAML or JSON could not be parsed`,
+    autoValidationDiagnostic({
+      code: "auto.validation.parse.yaml_invalid",
+      location: { file: file2 },
+      remediation: {
+        summary: "Fix the YAML or JSON syntax in this file, then validate again."
+      }
+    })
+  );
 }
 function primaryApplyDirectory() {
   return APPLY_DIRECTORIES[RESOURCE_KIND_AGENT];
@@ -105551,15 +105771,39 @@ function sourceFileIndex(files) {
 function isAbsoluteSourcePath(path2) {
   return path2.startsWith("/");
 }
-function isRecord4(value) {
+function isRecord5(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+function topLevelSourceLocations(node, file2, lineCounter) {
+  if (!isMap(node)) {
+    return {};
+  }
+  return Object.fromEntries(
+    node.items.flatMap((pair) => {
+      const key = pair.key?.toJSON?.();
+      if (typeof key !== "string") {
+        return [];
+      }
+      return [[key, sourceNodeLocation(pair.key, file2, lineCounter)]];
+    })
+  );
+}
+function sourceNodeLocation(node, file2, lineCounter) {
+  const range = node?.range;
+  const position = lineCounter.linePos(range?.[0] ?? 0);
+  return {
+    file: normalizeSourcePath(file2),
+    line: position.line,
+    column: position.col
+  };
+}
 var APPLY_DIRECTORIES, PROJECT_APPLY_RESOURCE_DIRECTORIES;
 var init_source = __esm({
   "../../packages/schemas/src/project-apply-files/source.ts"() {
     "use strict";
     init_agents();
     init_validation_diagnostics();
+    init_schema_version();
     APPLY_DIRECTORIES = {
       [RESOURCE_KIND_AGENT]: "agents"
     };
@@ -105576,7 +105820,7 @@ function readSingleDocument2(path2, fileIndex) {
   if (!file2) {
     throw new Error(`Agent import not found: ${path2}`);
   }
-  const documents = readDocumentsFromSource(file2);
+  const documents = readSourceDocuments(file2);
   if (documents.length !== 1) {
     throw new Error(
       `Agent authoring file ${file2.path} must contain exactly one document`
@@ -105630,7 +105874,7 @@ function resolveTemplateImportPath(importPath, fileIndex) {
   return key;
 }
 function removalDirectives2(document, path2) {
-  const raw = isRecord4(document.remove) ? document.remove : {};
+  const raw = isRecord5(document.remove) ? document.remove : {};
   const directives = [];
   for (const [target, value] of Object.entries(raw)) {
     const names = stringList2(value, `remove.${target}`);
@@ -105658,16 +105902,16 @@ var init_agent_document_merge = __esm({
 });
 
 // ../../packages/schemas/src/project-apply-files/source-locations.ts
-import { LineCounter, isMap, isSeq, parseAllDocuments as parseAllDocuments3 } from "yaml";
+import { LineCounter as LineCounter2, isMap as isMap2, isSeq, parseAllDocuments as parseAllDocuments3 } from "yaml";
 function readProjectConfigSourceLocations(file2) {
-  const locations = readYamlLocations(file2, "spec");
+  const locations = readYamlLocations(file2, "spec", 0);
   return Object.values(locations).map((location) => ({
     ...location,
     kind: RESOURCE_KIND_CONFIG,
     name: PROJECT_CONFIG_RESOURCE_NAME
   }));
 }
-function readAgentDraftSourceLocations(path2, fileIndex) {
+function readAgentDraftSourceLocations(path2, fileIndex, documentIndex) {
   const normalizedPath = normalizeSourcePath(path2);
   if (normalizedPath.startsWith("packages/")) {
     return {};
@@ -105676,30 +105920,39 @@ function readAgentDraftSourceLocations(path2, fileIndex) {
   if (!file2) {
     return {};
   }
-  return readYamlLocations(file2, "");
+  return readYamlLocations(file2, "", documentIndex);
 }
-function readYamlLocations(file2, rootPath) {
+function readYamlLocations(file2, rootPath, documentIndex) {
   const source = Buffer.from(file2.contentBase64, "base64").toString("utf8");
-  const lineCounter = new LineCounter();
+  const lineCounter = new LineCounter2();
   const documents = parseAllDocuments3(source, {
     keepSourceTokens: true,
     lineCounter
   });
-  if (documents.length !== 1 || documents[0]?.errors.length) {
+  const document = documents[documentIndex];
+  if (!document || document.errors.length > 0) {
     return {};
   }
   const locations = {};
-  collectNodeLocations(documents[0]?.contents, rootPath, locations, {
+  collectNodeLocations(document.contents, rootPath, locations, {
     file: normalizeSourcePath(file2.path),
     lineCounter
   });
   return locations;
 }
 function collectNodeLocations(node, path2, locations, context) {
-  if (isMap(node)) {
+  if (isMap2(node)) {
     for (const pair of node.items) {
       const key = String(pair.key?.toJSON());
-      if (["import", "imports", "remove", "variables"].includes(key)) {
+      if ([
+        "import",
+        "imports",
+        "remove",
+        "schemaVersion",
+        "templateVariables",
+        "variables",
+        "when"
+      ].includes(key)) {
         continue;
       }
       const childPath = propertyPath(path2, key);
@@ -105775,7 +106028,7 @@ function mergeValues3(base, override) {
   if (override === void 0) {
     return base;
   }
-  if (isRecord4(base) && isRecord4(override)) {
+  if (isRecord5(base) && isRecord5(override)) {
     const merged = { ...base };
     for (const [key, value] of Object.entries(override)) {
       merged[key] = mergeValues3(merged[key], value);
@@ -105795,7 +106048,7 @@ function sortJson(value) {
   if (Array.isArray(value)) {
     return value.map(sortJson);
   }
-  if (isRecord4(value)) {
+  if (isRecord5(value)) {
     return Object.fromEntries(
       Object.entries(value).sort(([left], [right]) => left.localeCompare(right)).map(([key, nested]) => [key, sortJson(nested)])
     );
@@ -105811,6 +106064,7 @@ var init_helpers = __esm({
       "import",
       "imports",
       "remove",
+      "schemaVersion",
       "templateVariables",
       "variables",
       "when"
@@ -105833,7 +106087,7 @@ function fileBackedStringField() {
   };
 }
 function rejectDirectiveObject(value, input) {
-  if (isRecord4(value) && "append" in value) {
+  if (isRecord5(value) && "append" in value) {
     throw new Error(
       `Invalid agent authoring file ${input.path}: ${input.field} does not support directive objects; append is supported on ${APPEND_CAPABLE_FIELDS}`
     );
@@ -105841,7 +106095,7 @@ function rejectDirectiveObject(value, input) {
   return value;
 }
 function resolveFileBackedString2(value, input) {
-  if (!isRecord4(value)) {
+  if (!isRecord5(value)) {
     return value;
   }
   if ("file" in value && !("append" in value)) {
@@ -105939,11 +106193,11 @@ function rejectUnresolvedAppendDirective(value) {
   );
 }
 function appendDirectiveFromMarker(value) {
-  if (!isRecord4(value)) {
+  if (!isRecord5(value)) {
     return void 0;
   }
   const marker = value[APPEND_DIRECTIVE_MARKER_KEY];
-  if (!isRecord4(marker)) {
+  if (!isRecord5(marker)) {
     return void 0;
   }
   return marker;
@@ -105965,7 +106219,7 @@ function inlineEnvironmentField() {
     target: "spec",
     merge: (base, override) => mergeValues3(base, override),
     compile: (value, context) => {
-      if (!isRecord4(value)) {
+      if (!isRecord5(value)) {
         return { resources: [], value };
       }
       const resource = inlineEnvironmentResource2(value, context.path);
@@ -105978,7 +106232,7 @@ function inlineIdentityField() {
     target: "spec",
     merge: (base, override) => mergeValues3(base, override),
     compile: (value, context) => {
-      if (!isRecord4(value)) {
+      if (!isRecord5(value)) {
         return { resources: [], value };
       }
       const resource = inlineIdentityResource2(
@@ -105991,7 +106245,7 @@ function inlineIdentityField() {
   };
 }
 function assertAgentAuthoringDocument(document, path2) {
-  if (!isRecord4(document) || !("kind" in document)) {
+  if (!isRecord5(document) || !("kind" in document)) {
     return;
   }
   if (document.kind === "session") {
@@ -106169,7 +106423,7 @@ function triggersField() {
   };
 }
 function mountItemKey(item) {
-  if (!isRecord4(item)) {
+  if (!isRecord5(item)) {
     return void 0;
   }
   if (typeof item.name === "string") {
@@ -106181,7 +106435,7 @@ function mountItemKey(item) {
   return void 0;
 }
 function triggerItemKey(item) {
-  if (!isRecord4(item)) {
+  if (!isRecord5(item)) {
     return void 0;
   }
   if (typeof item.name === "string") {
@@ -106234,7 +106488,7 @@ function removeAuthoringTriggerNames(value) {
     return value;
   }
   return value.map((trigger) => {
-    if (!isRecord4(trigger) || !("name" in trigger)) {
+    if (!isRecord5(trigger) || !("name" in trigger)) {
       return trigger;
     }
     const next = { ...trigger };
@@ -106256,7 +106510,7 @@ function namedMapField() {
     target: "spec",
     merge: (base, override) => mergeValues3(base, override),
     remove: (value, names) => {
-      if (!isRecord4(value)) {
+      if (!isRecord5(value)) {
         return value;
       }
       const next = { ...value };
@@ -106297,12 +106551,21 @@ var init_scalar = __esm({
 });
 
 // ../../packages/schemas/src/project-apply-files/agent-fields/index.ts
-function parseAgentDraft(document, path2, fileIndex) {
+function parseAgentDraft(sourceDocument, path2, fileIndex) {
+  const document = sourceDocument.value;
+  if (!isRecord5(document)) {
+    throw new Error(`Invalid agent authoring file ${path2}: expected object`);
+  }
   assertAgentAuthoringDocument(document, path2);
+  assertKnownAgentAuthoringFields(document, sourceDocument, path2);
   const sanitized = sanitizedAgentDocument2(document);
   assertNoLegacyEnvelopeFields(sanitized, path2);
   const draft = emptyAgentDraft();
-  draft.sourceLocations = readAgentDraftSourceLocations(path2, fileIndex);
+  draft.sourceLocations = readAgentDraftSourceLocations(
+    path2,
+    fileIndex,
+    sourceDocument.documentIndex
+  );
   for (const [key, value] of Object.entries(sanitized)) {
     if (value === void 0) {
       continue;
@@ -106362,7 +106625,7 @@ function mergeSourceLocations(base, override) {
         continue;
       }
       const prefix = `${target}.${key}`;
-      if (!isRecord4(value)) {
+      if (!isRecord5(value)) {
         merged = Object.fromEntries(
           Object.entries(merged).filter(
             ([path2]) => path2 !== prefix && !path2.startsWith(`${prefix}.`)
@@ -106438,10 +106701,36 @@ function supportedRemovalTargets() {
     (key) => AGENT_FIELDS[key]?.remove
   );
 }
+function assertKnownAgentAuthoringFields(document, sourceDocument, path2) {
+  if (sourceDocument.dialect.kind === "legacy") {
+    return;
+  }
+  const unknownField = Object.keys(document).find(
+    (key) => !AGENT_FIELDS[key] && !CONTROL_FIELDS.has(key)
+  );
+  if (!unknownField) {
+    return;
+  }
+  throw new AutoValidationDiagnosticError(
+    `Invalid agent authoring file ${path2}: unknown field "${unknownField}" for schemaVersion ${sourceDocument.dialect.version}`,
+    autoValidationDiagnostic({
+      code: "auto.validation.authoring.unknown_field",
+      path: [unknownField],
+      location: {
+        ...sourceDocument.topLevelLocations[unknownField] ?? sourceDocument.location,
+        documentIndex: sourceDocument.documentIndex
+      },
+      remediation: {
+        summary: `Remove "${unknownField}" or replace it with a supported Agent authoring field.`
+      }
+    })
+  );
+}
 var AGENT_FIELDS;
 var init_agent_fields = __esm({
   "../../packages/schemas/src/project-apply-files/agent-fields/index.ts"() {
     "use strict";
+    init_validation_diagnostics();
     init_source();
     init_source_locations();
     init_file_backed_string();
@@ -106490,7 +106779,7 @@ function readVariableScope(document, path2) {
   if (declared === void 0) {
     return /* @__PURE__ */ new Map();
   }
-  if (!isRecord4(declared)) {
+  if (!isRecord5(declared)) {
     throw new Error(
       `Invalid variables in ${path2}: variables must be a map of name to value`
     );
@@ -106579,7 +106868,7 @@ function substituteValue(value, scope, site) {
   if (Array.isArray(value)) {
     return value.map((item) => substituteValue(item, scope, site));
   }
-  if (isRecord4(value)) {
+  if (isRecord5(value)) {
     return Object.fromEntries(
       Object.entries(value).map(([key, nested]) => [
         key,
@@ -106616,7 +106905,7 @@ function availableNames(scope) {
 }
 function readVariableCondition(value, path2) {
   if (value === void 0) return void 0;
-  if (!isRecord4(value) || typeof value.variable !== "string" || value.variable.length === 0 || Object.keys(value).some((key) => key !== "variable")) {
+  if (!isRecord5(value) || typeof value.variable !== "string" || value.variable.length === 0 || Object.keys(value).some((key) => key !== "variable")) {
     throw new Error(
       `Invalid when in ${path2}: expected exactly { variable: <optional variable name> }`
     );
@@ -106641,7 +106930,7 @@ function collectOptionalVariableReferences(value, optional2, found) {
     }
     return;
   }
-  if (isRecord4(value)) {
+  if (isRecord5(value)) {
     for (const [key, nested] of Object.entries(value)) {
       if (key !== "templateVariables" && key !== "when") {
         collectOptionalVariableReferences(nested, optional2, found);
@@ -106662,7 +106951,7 @@ var init_template_variables = __esm({
 
 // ../../packages/schemas/src/project-apply-files/agent-authoring.ts
 function readApplyDocument(path2, document, fileIndex, contextVariables) {
-  assertAgentAuthoringDocument(document, path2);
+  assertAgentAuthoringDocument(document.value, path2);
   const result = compileAgentDocumentValue(
     document,
     path2,
@@ -106693,7 +106982,8 @@ function readApplyDocument(path2, document, fileIndex, contextVariables) {
         sourcePath: normalizeSourcePath(path2),
         draftLocations: result.sourceLocations,
         authoredTriggers: result.authoredTriggers,
-        generatedLocation
+        generatedLocation,
+        documentLocation: document.location
       })
     };
   });
@@ -106707,7 +106997,7 @@ function sourceLocationsForCompiledResource(input) {
     return [
       {
         file: input.sourcePath,
-        line: 1,
+        line: input.documentLocation.line,
         kind: input.resource.kind,
         name: input.resource.metadata.name,
         path: "$"
@@ -106742,7 +107032,7 @@ function projectCompiledTriggerSourceLocations(locations, authoredTriggers) {
   );
   let compiledIndex = 0;
   for (const [authoredIndex, trigger] of authoredTriggers.entries()) {
-    if (!isRecord4(trigger)) {
+    if (!isRecord5(trigger)) {
       continue;
     }
     const events = authoredTriggerEvents(trigger);
@@ -106803,14 +107093,15 @@ function authoredTriggerDisplayName(trigger, events) {
   }
   return "trigger";
 }
-function validateAgentFragmentDocument(document, path2, context) {
+function validateAgentFragmentDocument(sourceDocument, path2, context) {
   const normalizedPath = normalizeSourcePath(path2);
   if (context.stack.includes(normalizedPath)) {
     throw new Error(
       `Agent import cycle detected: ${[...context.stack, normalizedPath].join(" -> ")}`
     );
   }
-  if (!isRecord4(document)) {
+  const document = sourceDocument.value;
+  if (!isRecord5(document)) {
     throw new Error(`Invalid agent fragment file ${path2}: expected object`);
   }
   const variableContract = readTemplateVariableContract(
@@ -106845,7 +107136,7 @@ function validateAgentFragmentDocument(document, path2, context) {
   for (const removal of removalDirectives2(document, normalizedPath)) {
     assertSupportedAgentRemovalTarget(removal.target);
   }
-  parseAgentDraft(document, normalizedPath, context.fileIndex);
+  parseAgentDraft(sourceDocument, normalizedPath, context.fileIndex);
 }
 function dedupeGeneratedResources(records) {
   const recordsByKey = /* @__PURE__ */ new Map();
@@ -106875,16 +107166,16 @@ function conflictingGeneratedResourceMessage(key, existing, record3) {
   const location = existing.sourcePath === record3.sourcePath ? `defined more than once in "${existing.sourcePath}" with different content` : `defined differently in "${existing.sourcePath}" and "${record3.sourcePath}"`;
   return `Conflicting generated resource "${key}" from agent authoring: ${location}. Inline generated resources must be identical when they share a name.`;
 }
-function compileAgentDocumentValue(document, path2, fileIndex, contextVariables) {
+function compileAgentDocumentValue(sourceDocument, path2, fileIndex, contextVariables) {
   const templateVariableKinds = /* @__PURE__ */ new Map();
   collectTemplateVariableContracts(
-    document,
+    sourceDocument,
     path2,
     fileIndex,
     [],
     templateVariableKinds
   );
-  const draft = compileAgentDocument2(document, path2, {
+  const draft = compileAgentDocument2(sourceDocument, path2, {
     fileIndex,
     stack: [],
     templateVariableKinds,
@@ -106892,21 +107183,22 @@ function compileAgentDocumentValue(document, path2, fileIndex, contextVariables)
     ...contextVariables && Object.keys(contextVariables).length > 0 ? { contextVariables: new Map(Object.entries(contextVariables)) } : {}
   });
   const authoredTriggers = structuredClone(draft.spec.triggers);
-  const removals = isRecord4(document) ? removalDirectives2(document, normalizeSourcePath(path2)) : [];
+  const removals = isRecord5(sourceDocument.value) ? removalDirectives2(sourceDocument.value, normalizeSourcePath(path2)) : [];
   return {
     ...compileAgentDraftResources(draft, path2, removals),
     sourceLocations: draft.sourceLocations,
     authoredTriggers
   };
 }
-function collectTemplateVariableContracts(document, path2, fileIndex, stack, declarations) {
+function collectTemplateVariableContracts(sourceDocument, path2, fileIndex, stack, declarations) {
   const normalizedPath = normalizeSourcePath(path2);
   if (stack.includes(normalizedPath)) {
     throw new Error(
       `Agent import cycle detected: ${[...stack, normalizedPath].join(" -> ")}`
     );
   }
-  if (!isRecord4(document)) {
+  const document = sourceDocument.value;
+  if (!isRecord5(document)) {
     throw new Error(`Invalid agent authoring file ${path2}: expected object`);
   }
   registerTemplateVariableContract(
@@ -106929,14 +107221,15 @@ function collectTemplateVariableContracts(document, path2, fileIndex, stack, dec
     );
   }
 }
-function compileAgentDocument2(document, path2, context) {
+function compileAgentDocument2(sourceDocument, path2, context) {
   const normalizedPath = normalizeSourcePath(path2);
   if (context.stack.includes(normalizedPath)) {
     throw new Error(
       `Agent import cycle detected: ${[...context.stack, normalizedPath].join(" -> ")}`
     );
   }
-  if (!isRecord4(document)) {
+  const document = sourceDocument.value;
+  if (!isRecord5(document)) {
     throw new Error(`Invalid agent authoring file ${path2}: expected object`);
   }
   const variableContract = readTemplateVariableContract(
@@ -106977,13 +107270,13 @@ function compileAgentDocument2(document, path2, context) {
       context.fileIndex
     );
     const rawImportedDocument = readSingleDocument2(imported, context.fileIndex);
-    if (!isRecord4(rawImportedDocument)) {
+    if (!isRecord5(rawImportedDocument.value)) {
       throw new Error(
         `Invalid agent authoring file ${imported}: expected object`
       );
     }
     const importedContract = readTemplateVariableContract(
-      rawImportedDocument,
+      rawImportedDocument.value,
       imported
     );
     registerTemplateVariableContract(
@@ -106997,20 +107290,19 @@ function compileAgentDocument2(document, path2, context) {
       imported
     );
     if (!includeConditionalTemplateDocument({
-      document: rawImportedDocument,
+      document: rawImportedDocument.value,
       declarations: context.templateVariableKinds,
       variables,
       path: imported
     })) {
       continue;
     }
-    const importedDocument = substituteVariables(
-      rawImportedDocument,
-      variables,
-      {
+    const importedDocument = {
+      ...rawImportedDocument,
+      value: substituteVariables(rawImportedDocument.value, variables, {
         importPath
-      }
-    );
+      })
+    };
     merged = mergeAgentDrafts(
       merged,
       compileAgentDocument2(importedDocument, imported, {
@@ -107026,7 +107318,7 @@ function compileAgentDocument2(document, path2, context) {
   }
   return mergeAgentDrafts(
     merged,
-    parseAgentDraft(document, normalizedPath, context.fileIndex)
+    parseAgentDraft(sourceDocument, normalizedPath, context.fileIndex)
   );
 }
 var init_agent_authoring = __esm({
@@ -107304,10 +107596,13 @@ function collectInjectableTemplateReferences(files) {
 function hasBuiltInDefaultAgentDocument(files) {
   return files.some((file2) => {
     try {
-      return readDocumentsFromSource(file2).some(
-        (document) => isRecord4(document) && document.name === BUILT_IN_DEFAULT_AGENT_NAME
+      return readSourceDocuments(file2).some(
+        ({ value }) => isRecord5(value) && value.name === BUILT_IN_DEFAULT_AGENT_NAME
       );
-    } catch {
+    } catch (error51) {
+      if (isAuthoredSchemaVersionError(error51)) {
+        throw error51;
+      }
       return false;
     }
   });
@@ -107315,8 +107610,8 @@ function hasBuiltInDefaultAgentDocument(files) {
 function templateImportsInFile(file2) {
   try {
     const specifiers = [];
-    for (const document of readDocumentsFromSource(file2)) {
-      if (!isRecord4(document)) {
+    for (const { value: document } of readSourceDocuments(file2)) {
+      if (!isRecord5(document)) {
         continue;
       }
       for (const importPath of importPaths2(document)) {
@@ -107326,7 +107621,10 @@ function templateImportsInFile(file2) {
       }
     }
     return specifiers;
-  } catch {
+  } catch (error51) {
+    if (isAuthoredSchemaVersionError(error51)) {
+      throw error51;
+    }
     return [];
   }
 }
@@ -107336,6 +107634,7 @@ var init_template_injection = __esm({
     init_default_agent();
     init_templates();
     init_agent_document_merge();
+    init_schema_version();
     init_source();
   }
 });
@@ -107344,6 +107643,7 @@ var init_template_injection = __esm({
 function readProjectApplyDirectorySource(input) {
   const resourceRoot = normalizeSourcePath(input.resourceRoot ?? "");
   const displayResourceRoot2 = input.displayResourceRoot ?? (resourceRoot || ".auto");
+  assertSupportedSourceSchemaVersions(input.files);
   const files = injectManagedTemplateFiles({
     files: input.files,
     registry: defaultTemplateRegistry
@@ -107415,7 +107715,7 @@ function readProjectApplyFileSource(input) {
 }
 function readProjectApplyDocumentSourceFile(file2, options = {}) {
   const fileIndex = options.fileIndex ?? sourceFileIndex([file2]);
-  const documents = readDocumentsFromSource(file2);
+  const documents = readSourceDocuments(file2);
   if (documents.length === 0) {
     throw new AutoValidationDiagnosticError(
       `Invalid apply file: ${file2.path} is empty`,
@@ -107429,7 +107729,9 @@ function readProjectApplyDocumentSourceFile(file2, options = {}) {
     );
   }
   if (documents.length === 1) {
-    const system = ProjectApplySystemConfigSchema.safeParse(documents[0]);
+    const system = ProjectApplySystemConfigSchema.safeParse(
+      documents[0]?.value
+    );
     if (system.success) {
       return ProjectApplyRequestSchema.parse(system.data.spec);
     }
@@ -107466,13 +107768,13 @@ function readProjectConfigResource(files, resourceRoot) {
     );
   }
   const file2 = configFiles[0];
-  const documents = readDocumentsFromSource(file2);
+  const documents = readSourceDocuments(file2);
   if (documents.length > 1) {
     throw new Error(
       `Invalid project config ${file2.path}: expected a single document`
     );
   }
-  const parsed = ProjectConfigSpecSchema.safeParse(documents[0] ?? {});
+  const parsed = ProjectConfigSpecSchema.safeParse(documents[0]?.value ?? {});
   if (!parsed.success) {
     throw new AutoValidationDiagnosticError(
       `Invalid project config ${file2.path}: ${parsed.error.message}`,
@@ -107488,6 +107790,20 @@ function readProjectConfigResource(files, resourceRoot) {
     spec: parsed.data
   };
 }
+function assertSupportedSourceSchemaVersions(files) {
+  for (const file2 of files) {
+    if (!/\.(json|ya?ml)$/i.test(normalizeSourcePath(file2.path))) {
+      continue;
+    }
+    try {
+      readSourceDocuments(file2);
+    } catch (error51) {
+      if (isAuthoredSchemaVersionError(error51)) {
+        throw error51;
+      }
+    }
+  }
+}
 function assertNoLegacySessionSourceFiles(files, resourceRoot, displayResourceRoot2) {
   const legacyFiles = files.filter(
     (file2) => isResourceFileUnderDirectory(
@@ -107538,7 +107854,7 @@ function assertValidFragmentSourceFiles(files, resourceRoot, fileIndex) {
   );
   for (const file2 of fragments) {
     try {
-      const documents = readDocumentsFromSource(file2);
+      const documents = readSourceDocuments(file2);
       if (documents.length !== 1) {
         throw new Error(
           `Agent authoring file ${file2.path} must contain exactly one document`
@@ -107551,6 +107867,9 @@ function assertValidFragmentSourceFiles(files, resourceRoot, fileIndex) {
         variables: /* @__PURE__ */ new Map()
       });
     } catch (error51) {
+      if (isAuthoredSchemaVersionError(error51) || error51 instanceof AutoValidationDiagnosticError && error51.diagnostic.code === "auto.validation.authoring.unknown_field") {
+        throw error51;
+      }
       throw new Error(
         `Invalid fragment file ${file2.path}: ${error51 instanceof Error ? error51.message : String(error51)}`
       );
@@ -107570,6 +107889,7 @@ var init_project_apply_files = __esm({
     init_agent_authoring();
     init_apply_result();
     init_assets();
+    init_schema_version();
     init_source();
     init_source_locations();
     init_template_injection();
@@ -130112,7 +130432,7 @@ async function selectRepository(context, github, explicitRepo) {
   const selection = github.grant.providerResourceSelection;
   if (selection.kind === "selected") {
     const repos = selection.resources.map(
-      (resource) => isRecord5(resource) && typeof resource.fullName === "string" ? resource.fullName : void 0
+      (resource) => isRecord6(resource) && typeof resource.fullName === "string" ? resource.fullName : void 0
     ).filter(isDefined);
     if (repos.length === 1) {
       context.writeOutput(`Using GitHub repository ${repos[0]}.`);
@@ -130442,7 +130762,7 @@ function slackWorkspaceUrl(slack) {
 function organizationLabel(organization) {
   return `${organization.organizationName} (${organization.organizationSlug})`;
 }
-function isRecord5(value) {
+function isRecord6(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isDefined(value) {

package/package.json

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