@agentxm/extension-content 0.35.0 → 0.37.0

package/dist/src/index.d.ts

@@ -19,5 +19,6 @@ export { ArchiveGuardrailError, type ArchiveGuardrailLimits, ZIP_LOCAL_SIGNATURE
 export { FilteredPackageError, type ValidateFilteredPackageArgs, validateFilteredPackage, } from "./packaging/filtered-package-validation.js";
 export { IngestLimitError, IngestUnsupportedContentTypeError, REGISTRY_PUBLISH_MAX_ARCHIVE_BYTES, REGISTRY_PUBLISH_MAX_REQUEST_BYTES, enforceArchiveContentType, enforceArchiveSizeLimit, enforceRequestSizeLimit, } from "./packaging/ingest-limits.js";
 export { type NormalizePublishInputArgs, type PublishArchiveInput, type PublishInput, defaultReadEntry, normalizePublishInput, } from "./packaging/input-normalization.js";
-export { type DeclaredPublishIdentity, type ExtensionManifest, MANIFEST_FILENAME_BY_TYPE, MANIFEST_SCHEMA_BY_TYPE, ManifestError, type ManifestIdentity, ManifestIdentitySchema, type ManifestResolutionInput, type ResolvedManifest, manifestFilenameForType, manifestSchemaForType, resolveManifest, validateDeclaredManifestAlignment, validateManifestHasNoAgentsField, } from "./packaging/manifest-policy.js";
+export { type DeclaredPublishIdentity, type ExtensionManifest, MANIFEST_FILENAME_BY_TYPE, MANIFEST_FILENAMES, MANIFEST_SCHEMA_BY_TYPE, ManifestError, type ManifestIdentity, ManifestIdentitySchema, type ManifestResolutionInput, type ResolvedManifest, manifestFilenameForType, extensionTypeForManifestFilename, manifestSchemaForType, resolveManifest, validateDeclaredManifestAlignment, validateManifestHasNoAgentsField, } from "./packaging/manifest-policy.js";
+export { readExtensionManifest } from "./packaging/manifest-file.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.js

@@ -19,5 +19,6 @@ export { ArchiveGuardrailError, ZIP_LOCAL_SIGNATURE, checkForbiddenSourceEntries
 export { FilteredPackageError, validateFilteredPackage, } from "./packaging/filtered-package-validation.js";
 export { IngestLimitError, IngestUnsupportedContentTypeError, REGISTRY_PUBLISH_MAX_ARCHIVE_BYTES, REGISTRY_PUBLISH_MAX_REQUEST_BYTES, enforceArchiveContentType, enforceArchiveSizeLimit, enforceRequestSizeLimit, } from "./packaging/ingest-limits.js";
 export { defaultReadEntry, normalizePublishInput, } from "./packaging/input-normalization.js";
-export { MANIFEST_FILENAME_BY_TYPE, MANIFEST_SCHEMA_BY_TYPE, ManifestError, ManifestIdentitySchema, manifestFilenameForType, manifestSchemaForType, resolveManifest, validateDeclaredManifestAlignment, validateManifestHasNoAgentsField, } from "./packaging/manifest-policy.js";
+export { MANIFEST_FILENAME_BY_TYPE, MANIFEST_FILENAMES, MANIFEST_SCHEMA_BY_TYPE, ManifestError, ManifestIdentitySchema, manifestFilenameForType, extensionTypeForManifestFilename, manifestSchemaForType, resolveManifest, validateDeclaredManifestAlignment, validateManifestHasNoAgentsField, } from "./packaging/manifest-policy.js";
+export { readExtensionManifest } from "./packaging/manifest-file.js";
 //# sourceMappingURL=index.js.map

package/dist/src/lint/catalog/pack-accessor/platform.d.ts

@@ -10,11 +10,11 @@
  *
  * Packs are registry-only at v1 — there is no non-native variant. The caller
  * (`buildPackRuleContexts` or the CLI entry point) picks the root from
- * `computePackPathsForLayout` in `@agentxm/workspace/desired-state`.
+ * `computePackPathsForLayout` in `@agentxm/workspace-kernel/workspace-state`.
  *
  * The `pack.json` sits directly under `canonicalPath`; there is no
  * `src/` subdirectory like skills have — the pack install operation in
- * `@agentxm/workspace/lifecycle` owns the authoritative layout.
+ * `@agentxm/extension-kinds/packs` owns the authoritative layout.
  *
  * Bounds enforcement:
  *
@@ -48,7 +48,7 @@ export interface PackAccessorPlatform {
  *
  * `absoluteRoot` SHOULD be the absolute path to the pack root directory
  * (`canonicalPath` from `computePackPathsForLayout` in
- * `@agentxm/workspace/desired-state`).
+ * `@agentxm/workspace-kernel/workspace-state`).
  *
  * @experimental This API is unstable and may change without notice.
  */

package/dist/src/lint/catalog/pack-accessor/platform.js

@@ -10,11 +10,11 @@
  *
  * Packs are registry-only at v1 — there is no non-native variant. The caller
  * (`buildPackRuleContexts` or the CLI entry point) picks the root from
- * `computePackPathsForLayout` in `@agentxm/workspace/desired-state`.
+ * `computePackPathsForLayout` in `@agentxm/workspace-kernel/workspace-state`.
  *
  * The `pack.json` sits directly under `canonicalPath`; there is no
  * `src/` subdirectory like skills have — the pack install operation in
- * `@agentxm/workspace/lifecycle` owns the authoritative layout.
+ * `@agentxm/extension-kinds/packs` owns the authoritative layout.
  *
  * Bounds enforcement:
  *
@@ -39,7 +39,7 @@ import * as Effect from "effect/Effect";
  *
  * `absoluteRoot` SHOULD be the absolute path to the pack root directory
  * (`canonicalPath` from `computePackPathsForLayout` in
- * `@agentxm/workspace/desired-state`).
+ * `@agentxm/workspace-kernel/workspace-state`).
  *
  * @experimental This API is unstable and may change without notice.
  */

package/dist/src/lint/catalog/skill-accessor/platform.d.ts

@@ -45,7 +45,7 @@ export interface SkillAccessorPlatform {
  * `absoluteRoot` SHOULD be the absolute path to the skill root directory
  * (either `.../src/` for native, or the selected package directory for a
  * portable Agent Skill). The caller typically sources it from
- * `computeSkillPathsForLayout` in `@agentxm/workspace/desired-state`.
+ * `computeSkillPathsForLayout` in `@agentxm/workspace-kernel/workspace-state`.
  *
  * @experimental This API is unstable and may change without notice.
  */

package/dist/src/lint/catalog/skill-accessor/platform.js

@@ -36,7 +36,7 @@ import * as Effect from "effect/Effect";
  * `absoluteRoot` SHOULD be the absolute path to the skill root directory
  * (either `.../src/` for native, or the selected package directory for a
  * portable Agent Skill). The caller typically sources it from
- * `computeSkillPathsForLayout` in `@agentxm/workspace/desired-state`.
+ * `computeSkillPathsForLayout` in `@agentxm/workspace-kernel/workspace-state`.
  *
  * @experimental This API is unstable and may change without notice.
  */

package/dist/src/lint/describe-document.js

@@ -17,9 +17,8 @@
  * @packageDocumentation
  */
 import { extensionTypeSentenceLabels, extensionTypes, } from "@agentxm/extension-model/unstable/extensions/common";
-import { LOCKFILE_NAME } from "@agentxm/extension-model/unstable/workspace-files";
+import { LOCKFILE_NAME, SETTINGS_FILENAME, } from "@agentxm/extension-model/unstable/workspace-files";
 import { MANIFEST_FILENAME_BY_TYPE } from "../packaging/manifest-policy.js";
-import { SETTINGS_FILENAME } from "@agentxm/extension-model/unstable/workspace-files";
 /** Label used when a filename matches no known document. */
 export const UNKNOWN_DOCUMENT_LABEL = "Document";
 const capitalizeFirst = (value) => value.length === 0 ? value : `${value.charAt(0).toUpperCase()}${value.slice(1)}`;

package/dist/src/packaging/manifest-file.d.ts

@@ -0,0 +1,20 @@
+/** Read and validate a package manifest from its owning directory. */
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import type { ExtensionType } from "@agentxm/extension-model/unstable/extensions/common";
+import type { Handle } from "@agentxm/extension-model/unstable/extensions/handle";
+import { ManifestError, type ExtensionManifest, type ManifestIdentity } from "./manifest-policy.js";
+interface ReadManifestOptions {
+    readonly defaultOwner?: Handle;
+}
+interface ReadManifestResult {
+    readonly path: string;
+    readonly fileName: string;
+    readonly raw: unknown;
+    readonly manifest: ExtensionManifest;
+    readonly identity: ManifestIdentity;
+}
+export declare const readExtensionManifest: (directory: string, type: ExtensionType, options?: ReadManifestOptions) => Effect.Effect<ReadManifestResult, ManifestError, FileSystem.FileSystem | Path.Path>;
+export {};
+//# sourceMappingURL=manifest-file.d.ts.map

package/dist/src/packaging/manifest-file.js

@@ -0,0 +1,60 @@
+/** Read and validate a package manifest from its owning directory. */
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Schema from "effect/Schema";
+import * as SchemaIssue from "effect/SchemaIssue";
+import { ManifestError, ManifestIdentitySchema, manifestFilenameForType, manifestSchemaForType, } from "./manifest-policy.js";
+const withDefaultOwner = (raw, defaultOwner) => defaultOwner !== undefined &&
+    typeof raw === "object" &&
+    raw !== null &&
+    !Array.isArray(raw) &&
+    !Object.hasOwn(raw, "owner")
+    ? { ...raw, owner: defaultOwner }
+    : raw;
+export const readExtensionManifest = (directory, type, options) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const fileName = manifestFilenameForType(type);
+    const manifestPath = path.join(directory, fileName);
+    const exists = yield* fs.exists(manifestPath).pipe(Effect.mapError((cause) => new ManifestError({
+        code: "manifest_unreadable",
+        detail: `Manifest file "${manifestPath}" could not be inspected.`,
+        cause,
+    })));
+    if (!exists) {
+        return yield* new ManifestError({
+            code: "manifest_missing",
+            detail: `Expected manifest file "${fileName}" not found in ${directory}.`,
+        });
+    }
+    const content = yield* fs.readFileString(manifestPath).pipe(Effect.mapError((cause) => new ManifestError({
+        code: "manifest_unreadable",
+        detail: `Manifest file "${manifestPath}" could not be read.`,
+        cause,
+    })));
+    const parsed = yield* Schema.decodeUnknownEffect(Schema.fromJsonString(Schema.Unknown))(content).pipe(Effect.mapError((cause) => new ManifestError({
+        code: "manifest_invalid_json",
+        detail: `Manifest file "${fileName}" contains invalid JSON.`,
+        cause,
+    })));
+    const raw = withDefaultOwner(parsed, options?.defaultOwner);
+    const manifest = yield* Schema.decodeUnknownEffect(manifestSchemaForType(type))(raw).pipe(Effect.mapError((cause) => new ManifestError({
+        code: "manifest_schema_invalid",
+        detail: `Manifest file "${fileName}" does not conform to the ${type} manifest schema.`,
+        details: SchemaIssue.makeFormatterDefault()(cause.issue),
+    })));
+    const identity = yield* Schema.decodeUnknownEffect(ManifestIdentitySchema)(manifest).pipe(Effect.mapError((cause) => new ManifestError({
+        code: "manifest_schema_invalid",
+        detail: `Manifest file "${fileName}" is missing required identity fields.`,
+        details: SchemaIssue.makeFormatterDefault()(cause.issue),
+    })));
+    if (identity.type !== type) {
+        return yield* new ManifestError({
+            code: "manifest_schema_invalid",
+            detail: `Manifest declared type "${identity.type}" disagrees with ${fileName}.`,
+        });
+    }
+    return { path: manifestPath, fileName, raw, manifest, identity };
+});
+//# sourceMappingURL=manifest-file.js.map

package/dist/src/packaging/manifest-policy.d.ts

@@ -9,9 +9,10 @@ declare const ManifestError_base: new <A extends Record<string, any> = {}>(args:
     readonly _tag: "ManifestError";
 } & Readonly<A>;
 export declare class ManifestError extends ManifestError_base<{
-    readonly code: "manifest_missing" | "manifest_multiple" | "manifest_invalid_json" | "manifest_schema_invalid" | "companion_package_purl_has_version" | "companion_package_scheme_mismatch" | "companion_package_invalid" | "declared_manifest_mismatch";
+    readonly code: "manifest_missing" | "manifest_unreadable" | "manifest_multiple" | "manifest_invalid_json" | "manifest_schema_invalid" | "companion_package_purl_has_version" | "companion_package_scheme_mismatch" | "companion_package_invalid" | "declared_manifest_mismatch";
     readonly detail: string;
     readonly details?: unknown;
+    readonly cause?: unknown;
 }> {
 }
 export declare const MANIFEST_FILENAME_BY_TYPE: {
@@ -23,6 +24,8 @@ export declare const MANIFEST_FILENAME_BY_TYPE: {
     readonly hook: "hook.json";
     readonly knowledge: "knowledge.json";
 };
+export declare const MANIFEST_FILENAMES: ReadonlySet<string>;
+export declare const extensionTypeForManifestFilename: (fileName: string) => ExtensionType | undefined;
 export declare const manifestFilenameForType: (type: ExtensionType) => string;
 export declare const ManifestIdentitySchema: Schema.Struct<{
     readonly owner: Schema.brand<Schema.String, "Handle">;

package/dist/src/packaging/manifest-policy.js

@@ -3,7 +3,7 @@ import * as Effect from "effect/Effect";
 import * as Result from "effect/Result";
 import * as Schema from "effect/Schema";
 import * as SchemaIssue from "effect/SchemaIssue";
-import { ExtensionNameSchema, ExtensionTypeSchema, } from "@agentxm/extension-model/unstable/extensions/common";
+import { ExtensionNameSchema, ExtensionTypeSchema, extensionTypes, } from "@agentxm/extension-model/unstable/extensions/common";
 import { HookManifestSchema, HOOK_MANIFEST_FILENAME, } from "@agentxm/extension-model/unstable/hooks/manifest-schema";
 import { HandleSchema } from "@agentxm/extension-model/unstable/extensions/handle";
 import { KnowledgeManifestSchema, KNOWLEDGE_MANIFEST_FILENAME, } from "@agentxm/extension-model/unstable/knowledge/manifest-schema";
@@ -24,6 +24,8 @@ export const MANIFEST_FILENAME_BY_TYPE = {
     hook: HOOK_MANIFEST_FILENAME,
     knowledge: KNOWLEDGE_MANIFEST_FILENAME,
 };
+export const MANIFEST_FILENAMES = new Set(Object.values(MANIFEST_FILENAME_BY_TYPE));
+export const extensionTypeForManifestFilename = (fileName) => extensionTypes.find((type) => MANIFEST_FILENAME_BY_TYPE[type] === fileName);
 export const manifestFilenameForType = (type) => MANIFEST_FILENAME_BY_TYPE[type];
 export const ManifestIdentitySchema = Schema.Struct({
     owner: HandleSchema.pipe(Schema.annotateKey({ messageMissingKey: "owner is required" })),

package/package.json

@@ -4,9 +4,9 @@
     "url": "https://github.com/agentxm/axm/issues"
   },
   "dependencies": {
-    "@agentxm/extension-model": "^0.35.0",
+    "@agentxm/extension-model": "^0.37.0",
     "effect": "4.0.0-rc.117",
-    "yaml": "^2.9.0"
+    "yaml": "^2.9.1"
   },
   "description": "AXM extension content behavior: skill and subagent content parsing, Knowledge bundle inspection and search, the lint rule catalog, and archive and manifest validation shared by the axm CLI and the AgentXM Registry. Unstable and unsupported — use the axm.sh CLI.",
   "devDependencies": {
@@ -58,5 +58,5 @@
   },
   "sideEffects": false,
   "type": "module",
-  "version": "0.35.0"
+  "version": "0.37.0"
 }