@agentxm/extension-content 0.34.0 → 0.36.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/manifest-present.d.ts

@@ -13,5 +13,5 @@
  * @packageDocumentation
  */
 import type { PackRuleContext } from "../../context.js";
-export declare const manifestPresentRule: import("../../rule.ts").AdvisoryRule<PackRuleContext<import("../../context.js").PackContent>>;
+export declare const manifestPresentRule: import("../../rule.ts").AdvisoryRule<PackRuleContext<import("../../context.js").PackContent>, never>;
 //# sourceMappingURL=manifest-present.d.ts.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/shared/recommended-packs-rules.d.ts

@@ -30,18 +30,6 @@ export interface RecommendedPacksRuleOptions<C> {
     /** Reads the caller-decoded manifest JSON off the rule context. */
     readonly manifestJson: (context: C) => unknown;
 }
-/**
- * Split a `recommendedPacks` entry into its FQN and optional version range.
- *
- * Mirrors the separator search in `PackSpecSchema`: the range delimiter is the
- * first `@` after the last `/`, since the owner segment also starts with `@`.
- *
- * @experimental This API is unstable and may change without notice.
- */
-export declare const splitPackSpec: (spec: string) => {
-    readonly fqn: string;
-    readonly range: string | undefined;
-};
 /**
  * Build the `<namespace>/standalone-declaration-valid` rule for one catalog.
  *

package/dist/src/lint/catalog/shared/recommended-packs-rules.js

@@ -17,6 +17,7 @@
  * @packageDocumentation
  */
 import * as Effect from "effect/Effect";
+import { splitExtensionReference } from "@agentxm/extension-model/unstable/extensions/common";
 import { isManifestJsonParseFailure } from "./manifest-json.js";
 const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 /**
@@ -31,22 +32,6 @@ const manifestRecord = (input) => {
     return input;
 };
 const stringEntries = (value) => Array.isArray(value) ? value.filter((entry) => typeof entry === "string") : [];
-/**
- * Split a `recommendedPacks` entry into its FQN and optional version range.
- *
- * Mirrors the separator search in `PackSpecSchema`: the range delimiter is the
- * first `@` after the last `/`, since the owner segment also starts with `@`.
- *
- * @experimental This API is unstable and may change without notice.
- */
-export const splitPackSpec = (spec) => {
-    const lastSlash = spec.lastIndexOf("/");
-    const rangeAt = lastSlash > 0 ? spec.indexOf("@", lastSlash + 1) : -1;
-    if (rangeAt <= 0) {
-        return { fqn: spec, range: undefined };
-    }
-    return { fqn: spec.slice(0, rangeAt), range: spec.slice(rangeAt + 1) };
-};
 // -----------------------------------------------------------------------------
 // <namespace>/standalone-declaration-valid
 // -----------------------------------------------------------------------------
@@ -119,7 +104,7 @@ export const makeRecommendedPacksValidRule = (options) => {
             }
             const findings = [];
             for (const entry of stringEntries(manifest["recommendedPacks"])) {
-                const { fqn, range } = splitPackSpec(entry);
+                const { name: fqn, constraint: range } = splitExtensionReference(entry);
                 if (range === undefined) {
                     continue;
                 }

package/dist/src/lint/catalog/skill/manifest-present.d.ts

@@ -19,5 +19,5 @@
  * @packageDocumentation
  */
 import type { SkillRuleContext } from "../../context.js";
-export declare const manifestPresentRule: import("../../rule.ts").AdvisoryRule<SkillRuleContext<import("../../context.js").SkillContent>>;
+export declare const manifestPresentRule: import("../../rule.ts").AdvisoryRule<SkillRuleContext<import("../../context.js").SkillContent>, never>;
 //# sourceMappingURL=manifest-present.d.ts.map

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/catalog-metadata.js

@@ -570,6 +570,12 @@ export const lintCatalogRuleMetadata = defineLintCatalog([
         group: "workspace",
         views: workspaceView,
     },
+    {
+        id: "workspace/deprecated-installed",
+        defaultSeverity: "warning",
+        group: "workspace",
+        views: workspaceView,
+    },
     {
         id: "workspace/authored-package-declared",
         defaultSeverity: "warning",

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/lint/evaluate.d.ts

@@ -24,8 +24,8 @@ import type { LintFinding, LintRule } from "./rule.js";
  *
  * @experimental This API is unstable and may change without notice.
  */
-export interface Evaluated<C> {
-    readonly rule: LintRule<C>;
+export interface Evaluated<C, E = never> {
+    readonly rule: LintRule<C, E>;
     readonly context: C;
     readonly findings: ReadonlyArray<LintFinding>;
 }
@@ -43,5 +43,5 @@ export interface Evaluated<C> {
  *
  * @experimental This API is unstable and may change without notice.
  */
-export declare const evaluateContexts: <C>(rules: ReadonlyArray<LintRule<C>>, contexts: ReadonlyArray<C>, config: LintConfig) => Effect.Effect<ReadonlyArray<Evaluated<C>>>;
+export declare const evaluateContexts: <C, E>(rules: ReadonlyArray<LintRule<C, E>>, contexts: ReadonlyArray<C>, config: LintConfig) => Effect.Effect<ReadonlyArray<Evaluated<C, E>>, E>;
 //# sourceMappingURL=evaluate.d.ts.map

package/dist/src/lint/rule.d.ts

@@ -84,14 +84,14 @@ export interface RuleBase {
  *
  * @experimental This API is unstable and may change without notice.
  */
-export interface AdvisoryRule<C> extends RuleBase {
+export interface AdvisoryRule<C, E = never> extends RuleBase {
     readonly kind: "advisory";
-    readonly check: (context: C) => Effect.Effect<ReadonlyArray<AdvisoryFinding>>;
+    readonly check: (context: C) => Effect.Effect<ReadonlyArray<AdvisoryFinding>, E>;
 }
 /**
  * Discriminated union of lint rules over a caller-built rule-context type `C`.
  *
  * @experimental This API is unstable and may change without notice.
  */
-export type LintRule<C> = AdvisoryRule<C>;
+export type LintRule<C, E = never> = AdvisoryRule<C, E>;
 //# sourceMappingURL=rule.d.ts.map

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,7 +4,7 @@
     "url": "https://github.com/agentxm/axm/issues"
   },
   "dependencies": {
-    "@agentxm/extension-model": "^0.34.0",
+    "@agentxm/extension-model": "^0.36.0",
     "effect": "4.0.0-rc.117",
     "yaml": "^2.9.0"
   },
@@ -15,7 +15,7 @@
     "@fast-check/vitest": "^0.5.0",
     "@typescript/native": "npm:typescript@^7.0.2",
     "typescript": "npm:@typescript/typescript6@^6.0.2",
-    "vitest": "^5.0.0"
+    "vitest": "^5.0.1"
   },
   "engines": {
     "node": ">=24.19.0"
@@ -58,5 +58,5 @@
   },
   "sideEffects": false,
   "type": "module",
-  "version": "0.34.0"
+  "version": "0.36.0"
 }