@agentxm/extension-model 0.38.0 → 0.39.0

package/dist/src/unstable/sources/types.d.ts

@@ -19,7 +19,7 @@ import type { Handle } from "../extensions/handle.js";
  *
  * @experimental
  */
-export declare const SourceTypeSchema: Schema.Literals<readonly ["git", "registry", "local", "inline", "workspace"]>;
+export declare const SourceTypeSchema: Schema.Literals<readonly ["git", "http", "registry", "local", "inline", "workspace"]>;
 /**
  * Inferred type for SourceTypeSchema.
  *
@@ -36,7 +36,7 @@ export type SourceType = Schema.Schema.Type<typeof SourceTypeSchema>;
  *
  * @experimental This API is unstable and may change without notice.
  */
-export declare const RefTypeSchema: Schema.Literals<readonly ["git-hosted", "registry", "local", "workspace"]>;
+export declare const RefTypeSchema: Schema.Literals<readonly ["git-hosted", "http", "registry", "local", "workspace"]>;
 /**
  * Inferred type for RefTypeSchema.
  *
@@ -73,7 +73,10 @@ export interface WorkspaceSourceHost {
     readonly type: "workspace";
 }
 /** @experimental */
-export type SourceHost = GitSourceHost | RegistrySourceHost | LocalSourceHost | InlineSourceHost | WorkspaceSourceHost;
+export interface HttpSourceHost {
+    readonly type: "http";
+}
+export type SourceHost = HttpSourceHost | GitSourceHost | RegistrySourceHost | LocalSourceHost | InlineSourceHost | WorkspaceSourceHost;
 /** @experimental */
 export interface GitSourceParams {
     readonly type: "git";
@@ -108,7 +111,14 @@ export interface WorkspaceSourceParams {
     readonly name: ExtensionName;
 }
 /** @experimental */
-export type SourceParams = GitSourceParams | RegistrySourceParams | LocalSourceParams | InlineSourceParams | WorkspaceSourceParams;
+export interface HttpSourceParams {
+    readonly type: "http";
+    readonly url: URL;
+    readonly kind: "skill-md" | "archive" | "index";
+    readonly entry?: string;
+}
+export type HttpSource = HttpSourceHost & HttpSourceParams;
+export type SourceParams = HttpSourceParams | GitSourceParams | RegistrySourceParams | LocalSourceParams | InlineSourceParams | WorkspaceSourceParams;
 /** @experimental */
 export type InlineSource = InlineSourceHost & InlineSourceParams;
 /** @experimental */
@@ -120,11 +130,11 @@ export type LocalSource = LocalSourceHost & LocalSourceParams;
 /** @experimental */
 export type WorkspaceSource = WorkspaceSourceHost & WorkspaceSourceParams;
 /** @experimental */
-export type Source = GitSource | RegistrySource | LocalSource | WorkspaceSource;
+export type Source = HttpSource | GitSource | RegistrySource | LocalSource | WorkspaceSource;
 /** All git-based sources. Hosted-provider syntax expands to this source. @experimental */
 export type GitBasedSource = GitSource;
 /** Sources that require host configuration from settings. @experimental */
 export type ConfiguredSourceHost = RegistrySourceHost;
 /** Sources that are self-describing (no settings config needed). @experimental */
-export type SelfDescribingSourceHost = GitSourceHost | LocalSourceHost;
+export type SelfDescribingSourceHost = GitSourceHost | LocalSourceHost | HttpSourceHost;
 //# sourceMappingURL=types.d.ts.map

package/dist/src/unstable/sources/types.js

@@ -21,6 +21,7 @@ import * as Schema from "effect/Schema";
  */
 export const SourceTypeSchema = Schema.Literals([
     "git",
+    "http",
     "registry",
     "local",
     "inline",
@@ -45,6 +46,7 @@ export const SourceTypeSchema = Schema.Literals([
  */
 export const RefTypeSchema = Schema.Literals([
     "git-hosted",
+    "http",
     "registry",
     "local",
     "workspace",

package/dist/src/unstable/subagents/manifest-schema.d.ts

@@ -1,8 +1,4 @@
-/**
- * Subagent manifest schema definition.
- *
- * @experimental This API is unstable and may change without notice.
- */
+/** Subagent packages declare portable instructions and explicit native implementations. */
 import * as Schema from "effect/Schema";
 /**
  * Filename for subagent manifest files.
@@ -16,24 +12,57 @@ export declare const MANIFEST_FILENAME = "subagent.json";
  * @experimental This API is unstable and may change without notice.
  */
 export declare const MANIFEST_SCHEMA_URL = "https://axm.sh/schemas/subagent.schema.json";
-/**
- * Schema for subagent manifest files (subagent.json).
- *
- * The manifest carries registry-facing identity and metadata. Fields like
- * `model`, `toolAccess`, and `background` live (if at all) in the content
- * file's frontmatter and are passed through to agent-native files verbatim;
- * the manifest does not mirror them.
- *
- * @experimental This API is unstable and may change without notice.
- */
+/** A contained, portable package file reference, never a URL or host path. */
+export declare const SubagentSourcePathSchema: Schema.String;
+/** Native names are file stems and need not equal the package identity. */
+export declare const SubagentNativeNameSchema: Schema.String;
+export declare const SubagentConfigurationSchema: Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>;
+export declare const SubagentCoreSchema: Schema.Struct<{
+    readonly instructions: Schema.String;
+    readonly name: Schema.optional<Schema.String>;
+}>;
+export declare const SubagentImplementationSchema: Schema.Union<readonly [Schema.Struct<{
+    readonly kind: Schema.Literal<"customized">;
+    readonly source: Schema.optional<Schema.Never>;
+    readonly configuration: Schema.optional<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+    readonly instructions: Schema.optional<Schema.Struct<{
+        readonly mode: Schema.Literals<readonly ["append", "replace"]>;
+        readonly source: Schema.String;
+    }>>;
+}>, Schema.Struct<{
+    readonly kind: Schema.Literal<"native">;
+    readonly source: Schema.String;
+    readonly configuration: Schema.optional<Schema.Never>;
+    readonly instructions: Schema.optional<Schema.Never>;
+}>]>;
 export declare const SubagentManifestSchema: Schema.Struct<{
-    readonly type: Schema.Literal<"subagent">;
-    readonly name: Schema.brand<Schema.NonEmptyString, "ExtensionName">;
     readonly enhances: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
     readonly requires: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
-    readonly fallback: Schema.optional<Schema.Literals<readonly ["auto", "none"]>>;
     readonly recommendedPacks: Schema.optional<Schema.$Array<Schema.brand<Schema.NonEmptyString, "PackSpec">>>;
     readonly standalone: Schema.optional<Schema.Boolean>;
+    readonly type: Schema.Literal<"subagent">;
+    readonly name: Schema.brand<Schema.NonEmptyString, "ExtensionName">;
+    readonly core: Schema.optional<Schema.Struct<{
+        readonly instructions: Schema.String;
+        readonly name: Schema.optional<Schema.String>;
+    }>>;
+    readonly implementations: Schema.optional<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.Struct<{
+        readonly kind: Schema.Literal<"customized">;
+        readonly source: Schema.optional<Schema.Never>;
+        readonly configuration: Schema.optional<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>;
+        readonly instructions: Schema.optional<Schema.Struct<{
+            readonly mode: Schema.Literals<readonly ["append", "replace"]>;
+            readonly source: Schema.String;
+        }>>;
+    }>, Schema.Struct<{
+        readonly kind: Schema.Literal<"native">;
+        readonly source: Schema.String;
+        readonly configuration: Schema.optional<Schema.Never>;
+        readonly instructions: Schema.optional<Schema.Never>;
+    }>]>>>;
+    readonly fallback: Schema.optional<Schema.Never>;
+    readonly agentOverrides: Schema.optional<Schema.Never>;
+    readonly agents: Schema.optional<Schema.Never>;
     readonly publish: Schema.optional<Schema.Struct<{
         readonly visibility: Schema.optional<Schema.Literals<readonly ["public", "private"]>>;
         readonly ignore: Schema.optional<Schema.$Array<Schema.NonEmptyString>>;
@@ -78,4 +107,5 @@ export declare const SubagentManifestSchema: Schema.Struct<{
  * @experimental This API is unstable and may change without notice.
  */
 export type SubagentManifest = Schema.Schema.Type<typeof SubagentManifestSchema>;
+export type SubagentImplementation = Schema.Schema.Type<typeof SubagentImplementationSchema>;
 //# sourceMappingURL=manifest-schema.d.ts.map

package/dist/src/unstable/subagents/manifest-schema.js

@@ -1,9 +1,6 @@
-/**
- * Subagent manifest schema definition.
- *
- * @experimental This API is unstable and may change without notice.
- */
+/** Subagent packages declare portable instructions and explicit native implementations. */
 import * as Schema from "effect/Schema";
+import { AgentIdSchema } from "../agent-capabilities/identity.js";
 import { CommonManifestBaseFields, ExtensionNameSchema, NonPackManifestFields, } from "../extensions/common.js";
 /**
  * Filename for subagent manifest files.
@@ -17,27 +14,97 @@ export const MANIFEST_FILENAME = "subagent.json";
  * @experimental This API is unstable and may change without notice.
  */
 export const MANIFEST_SCHEMA_URL = "https://axm.sh/schemas/subagent.schema.json";
-/**
- * Schema for subagent manifest files (subagent.json).
- *
- * The manifest carries registry-facing identity and metadata. Fields like
- * `model`, `toolAccess`, and `background` live (if at all) in the content
- * file's frontmatter and are passed through to agent-native files verbatim;
- * the manifest does not mirror them.
- *
- * @experimental This API is unstable and may change without notice.
- */
+/** A contained, portable package file reference, never a URL or host path. */
+export const SubagentSourcePathSchema = Schema.String.check(Schema.isPattern(/^(?!\/)(?!.*(?:^|\/)\.{1,2}(?:\/|$))(?!.*\/\/)[^\\\p{Cc}:]+$/u), Schema.makeFilter((value) => !value.endsWith("/"), {
+    message: "Expected a contained package-relative file path",
+    toJsonSchema: () => ({ not: { pattern: "/$" } }),
+})).annotate({
+    description: "Package-relative regular file path; traversal and host paths are forbidden.",
+});
+/** Native names are file stems and need not equal the package identity. */
+export const SubagentNativeNameSchema = Schema.String.check(Schema.isPattern(/^[A-Za-z0-9][A-Za-z0-9_-]*$/)).annotate({ description: "Native agent name, independent of the AXM package name." });
+const safeConfigurationKey = Schema.String.check(Schema.isPattern(/^(?!(?:name|description|instructions|developer_instructions|prompt|systemPrompt|system_prompt|roleDefinition|agentOverrides|fallback|__proto__|prototype|constructor)$).+$/));
+export const SubagentConfigurationSchema = Schema.Record(Schema.String, Schema.Json)
+    .check(Schema.isPropertyNames(safeConfigurationKey))
+    .annotate({
+    description: "Opaque native configuration; identity and instruction fields belong to the core or a complete native implementation.",
+});
+export const SubagentCoreSchema = Schema.Struct({
+    instructions: SubagentSourcePathSchema,
+    name: Schema.optional(SubagentNativeNameSchema),
+});
+export const SubagentImplementationSchema = Schema.Union([
+    Schema.Struct({
+        kind: Schema.Literal("customized"),
+        source: Schema.optional(Schema.Never),
+        configuration: Schema.optional(SubagentConfigurationSchema),
+        instructions: Schema.optional(Schema.Struct({
+            mode: Schema.Literals(["append", "replace"]),
+            source: SubagentSourcePathSchema,
+        })),
+    }),
+    Schema.Struct({
+        kind: Schema.Literal("native"),
+        source: SubagentSourcePathSchema,
+        configuration: Schema.optional(Schema.Never),
+        instructions: Schema.optional(Schema.Never),
+    }),
+]);
 export const SubagentManifestSchema = Schema.Struct({
     $schema: Schema.optional(Schema.String),
     ...CommonManifestBaseFields,
-    ...NonPackManifestFields,
+    enhances: NonPackManifestFields.enhances,
+    requires: NonPackManifestFields.requires,
+    recommendedPacks: NonPackManifestFields.recommendedPacks,
+    standalone: NonPackManifestFields.standalone,
     type: Schema.Literal("subagent"),
     name: ExtensionNameSchema.pipe(Schema.annotateKey({ messageMissingKey: "subagent name is required" }), Schema.annotate({
         description: "Short name for this subagent within its owner namespace. Combined with owner, forms the FQN @owner/subagents/<name>.",
     })),
-}).annotate({
+    core: Schema.optional(SubagentCoreSchema),
+    implementations: Schema.optional(Schema.Record(Schema.String, SubagentImplementationSchema).check(Schema.isPropertyNames(AgentIdSchema))),
+    // Reject obsolete contracts even at readers that otherwise discard excess fields.
+    fallback: Schema.optional(Schema.Never),
+    agentOverrides: Schema.optional(Schema.Never),
+    agents: Schema.optional(Schema.Never),
+})
+    .check(Schema.makeFilter((manifest) => {
+    const implementations = Object.values(manifest.implementations ?? {});
+    if (manifest.core === undefined) {
+        if (implementations.some((implementation) => implementation.kind === "customized")) {
+            return "A customized implementation requires a portable core";
+        }
+        if (!implementations.some((implementation) => implementation.kind === "native")) {
+            return "A subagent requires a portable core or at least one native implementation";
+        }
+    }
+    else if (manifest.description === undefined || manifest.description.trim().length === 0) {
+        return "A portable core requires a nonempty manifest description";
+    }
+    return true;
+}, {
+    toJsonSchema: () => ({
+        anyOf: [
+            {
+                required: ["core", "description"],
+                properties: { description: { type: "string", pattern: "\\S" } },
+            },
+            {
+                not: { required: ["core"] },
+                required: ["implementations"],
+                properties: {
+                    implementations: {
+                        minProperties: 1,
+                        additionalProperties: { properties: { kind: { const: "native" } } },
+                    },
+                },
+            },
+        ],
+    }),
+}))
+    .annotate({
     identifier: "SubagentManifest",
     title: "Subagent Manifest",
-    description: "Extension manifest file for subagent. Carries the registry-facing identity, version, and metadata.",
+    description: "One subagent package with portable instructions, explicit per-agent customization, or complete native implementations.",
 });
 //# sourceMappingURL=manifest-schema.js.map

package/package.json

@@ -11,7 +11,7 @@
   },
   "description": "Shared AgentXM extension model: identities, manifests, version constraints, and agent capabilities. Unstable and unsupported — use the axm.sh CLI.",
   "devDependencies": {
-    "@agentxm/specification-metadata": "0.38.0",
+    "@agentxm/specification-metadata": "0.39.0",
     "@effect/vitest": "4.0.0-rc.117",
     "@fast-check/vitest": "^0.5.0",
     "@types/semver": "^7.8.0",
@@ -283,6 +283,14 @@
     "./unstable/extensions/name-patterns": {
       "types": "./dist/src/unstable/extensions/name-patterns.d.ts",
       "default": "./dist/src/unstable/extensions/name-patterns.js"
+    },
+    "./unstable/sources/http-artifact": {
+      "types": "./dist/src/unstable/sources/http-artifact.d.ts",
+      "default": "./dist/src/unstable/sources/http-artifact.js"
+    },
+    "./unstable/hooks/resolution": {
+      "types": "./dist/src/unstable/hooks/resolution.d.ts",
+      "default": "./dist/src/unstable/hooks/resolution.js"
     }
   },
   "files": [
@@ -305,5 +313,5 @@
   },
   "sideEffects": false,
   "type": "module",
-  "version": "0.38.0"
+  "version": "0.39.0"
 }