@agentxm/extension-model 0.38.0 → 0.39.0

package/dist/src/unstable/extensions/common.d.ts

@@ -87,7 +87,7 @@ export type StandardGoverns = "package-body" | "runtime-protocol" | "host-file";
 /** Workspace-level capability a type participates in. */
 export type WorkspaceCapabilityKey = "instructions";
 /** Authority families an extension may be installed from. */
-export declare const extensionSourceFamilies: readonly ["git", "registry", "path", "workspace"];
+export declare const extensionSourceFamilies: readonly ["git", "registry", "path", "workspace", "http"];
 export type ExtensionSourceFamily = (typeof extensionSourceFamilies)[number];
 type ExtensionInstallability = {
     readonly [Family in ExtensionSourceFamily]: boolean;
@@ -137,6 +137,7 @@ export declare const EXTENSION_TYPE_TABLE: {
             readonly registry: true;
             readonly path: true;
             readonly workspace: true;
+            readonly http: true;
         };
         readonly workspaceCapability: null;
     };
@@ -156,6 +157,7 @@ export declare const EXTENSION_TYPE_TABLE: {
             readonly registry: true;
             readonly path: true;
             readonly workspace: true;
+            readonly http: false;
         };
         readonly workspaceCapability: null;
     };
@@ -175,6 +177,7 @@ export declare const EXTENSION_TYPE_TABLE: {
             readonly registry: true;
             readonly path: true;
             readonly workspace: true;
+            readonly http: false;
         };
         readonly workspaceCapability: null;
     };
@@ -194,6 +197,7 @@ export declare const EXTENSION_TYPE_TABLE: {
             readonly registry: true;
             readonly path: true;
             readonly workspace: true;
+            readonly http: false;
         };
         readonly workspaceCapability: "instructions";
     };
@@ -213,6 +217,7 @@ export declare const EXTENSION_TYPE_TABLE: {
             readonly registry: true;
             readonly path: true;
             readonly workspace: true;
+            readonly http: false;
         };
         readonly workspaceCapability: null;
     };
@@ -232,6 +237,7 @@ export declare const EXTENSION_TYPE_TABLE: {
             readonly registry: true;
             readonly path: true;
             readonly workspace: true;
+            readonly http: false;
         };
         readonly workspaceCapability: null;
     };
@@ -251,6 +257,7 @@ export declare const EXTENSION_TYPE_TABLE: {
             readonly registry: true;
             readonly path: true;
             readonly workspace: true;
+            readonly http: false;
         };
         readonly workspaceCapability: null;
     };
@@ -299,7 +306,7 @@ export type RegistryType = PerAgentType | WorkspaceType;
 export type InputType = TypesWhere<"installInputs", true>;
 /** Extension types installable from one source family. */
 export type InstallableFrom<Family extends ExtensionSourceFamily> = {
-    [Type in ExtensionType]: ExtensionTypeRows[Type]["installableFrom"][Family] extends true ? Type : never;
+    [Type in ExtensionType]: true extends ExtensionTypeRows[Type]["installableFrom"][Family] ? Type : never;
 }[ExtensionType];
 /** Extension types whose governing standard covers the package body. */
 export type BodyGovernedType = TypesWhere<"governs", "package-body">;
@@ -326,36 +333,43 @@ export declare const INSTALLABLE_FROM_BY_TYPE: Record<"skill" | "mcp-server" | "
     readonly registry: true;
     readonly path: true;
     readonly workspace: true;
+    readonly http: true;
 } | {
     readonly git: true;
     readonly registry: true;
     readonly path: true;
     readonly workspace: true;
+    readonly http: false;
 } | {
     readonly git: true;
     readonly registry: true;
     readonly path: true;
     readonly workspace: true;
+    readonly http: false;
 } | {
     readonly git: true;
     readonly registry: true;
     readonly path: true;
     readonly workspace: true;
+    readonly http: false;
 } | {
     readonly git: true;
     readonly registry: true;
     readonly path: true;
     readonly workspace: true;
+    readonly http: false;
 } | {
     readonly git: true;
     readonly registry: true;
     readonly path: true;
     readonly workspace: true;
+    readonly http: false;
 } | {
     readonly git: true;
     readonly registry: true;
     readonly path: true;
     readonly workspace: true;
+    readonly http: false;
 }>;
 export declare const extensionTypesInstallableFrom: <Family extends ExtensionSourceFamily>(family: Family) => ReadonlyArray<InstallableFrom<Family>>;
 export declare const isInstallableFrom: <Family extends ExtensionSourceFamily>(type: ExtensionType, family: Family) => type is InstallableFrom<Family>;
@@ -681,7 +695,7 @@ export { AgentIdSchema };
  *
  * @experimental This API is unstable and may change without notice.
  */
-export declare const ConfigurableAgentIdSchema: Schema.Literals<readonly ["adal", "fx", "muse-code", "mimo-code", "coder-agents", "aider-desk", "amp", "antigravity", "antigravity-cli", "augment", "claude-code", "cline", "codearts-agent", "codebuddy", "codemaker", "codestudio", "codex", "command-code", "continue", "cortex", "crush", "cursor", "deepagents", "devin", "dexto", "droid", "firebender", "forgecode", "gemini-cli", "github-copilot-cli", "goose", "grok-cli", "hermes", "ibm-bob", "iflow-cli", "junie", "lingma", "kilo", "kimi-cli", "kiro-cli", "kode", "mcpjam", "minimax-code", "mistral-vibe", "mux", "neovate", "openclaw", "opencode", "openhands", "ona", "pi", "pochi", "qoder", "qoder-cn", "qwen-code", "replit", "roo", "rovodev", "tabnine-cli", "trae-cn", "trae", "warp", "windsurf", "zencoder", "zed", "zenflow"]>;
+export declare const ConfigurableAgentIdSchema: Schema.Literals<readonly ["adal", "fx", "muse-code", "mimo-code", "coder-agents", "aider-desk", "amp", "antigravity", "antigravity-cli", "augment", "claude-code", "cline", "codearts-agent", "codebuddy", "codemaker", "codestudio", "codex", "command-code", "continue", "cortex", "crush", "cursor", "deepagents", "devin", "dexto", "droid", "firebender", "forgecode", "gemini-cli", "github-copilot-cli", "goose", "grok-cli", "hermes", "ibm-bob", "iflow-cli", "junie", "lingma", "kilo", "kimi-cli", "kiro-cli", "kode", "mcpjam", "minimax-code", "mistral-vibe", "mux", "neovate", "openclaw", "opencode", "openhands", "ona", "pi", "vscode", "pochi", "qoder", "qoder-cn", "qwen-code", "replit", "roo", "rovodev", "tabnine-cli", "trae-cn", "trae", "warp", "windsurf", "zencoder", "zed", "zenflow"]>;
 /**
  * Inferred type for AgentId schema.
  *

package/dist/src/unstable/extensions/common.js

@@ -113,7 +113,7 @@ export const LicenseSchema = Schema.String.annotate({
     ? true
     : "Expected a valid SPDX license expression or UNLICENSED"));
 /** Authority families an extension may be installed from. */
-export const extensionSourceFamilies = ["git", "registry", "path", "workspace"];
+export const extensionSourceFamilies = ["git", "registry", "path", "workspace", "http"];
 /**
  * Single source of truth for extension type naming. Row order is the canonical
  * display order. Every other type-naming export in this module derives from
@@ -136,7 +136,7 @@ export const EXTENSION_TYPE_TABLE = {
         placement: "per-agent",
         governs: "package-body",
         installInputs: false,
-        installableFrom: { git: true, registry: true, path: true, workspace: true },
+        installableFrom: { git: true, registry: true, path: true, workspace: true, http: true },
         workspaceCapability: null,
     },
     "mcp-server": {
@@ -150,7 +150,7 @@ export const EXTENSION_TYPE_TABLE = {
         placement: "per-agent",
         governs: "runtime-protocol",
         installInputs: true,
-        installableFrom: { git: true, registry: true, path: true, workspace: true },
+        installableFrom: { git: true, registry: true, path: true, workspace: true, http: false },
         workspaceCapability: null,
     },
     subagent: {
@@ -164,7 +164,7 @@ export const EXTENSION_TYPE_TABLE = {
         placement: "per-agent",
         governs: null,
         installInputs: false,
-        installableFrom: { git: true, registry: true, path: true, workspace: true },
+        installableFrom: { git: true, registry: true, path: true, workspace: true, http: false },
         workspaceCapability: null,
     },
     rule: {
@@ -178,7 +178,7 @@ export const EXTENSION_TYPE_TABLE = {
         placement: "workspace",
         governs: "host-file",
         installInputs: false,
-        installableFrom: { git: true, registry: true, path: true, workspace: true },
+        installableFrom: { git: true, registry: true, path: true, workspace: true, http: false },
         workspaceCapability: "instructions",
     },
     hook: {
@@ -192,7 +192,7 @@ export const EXTENSION_TYPE_TABLE = {
         placement: "per-agent",
         governs: null,
         installInputs: false,
-        installableFrom: { git: true, registry: true, path: true, workspace: true },
+        installableFrom: { git: true, registry: true, path: true, workspace: true, http: false },
         workspaceCapability: null,
     },
     knowledge: {
@@ -206,7 +206,7 @@ export const EXTENSION_TYPE_TABLE = {
         placement: "workspace",
         governs: "package-body",
         installInputs: false,
-        installableFrom: { git: true, registry: true, path: true, workspace: true },
+        installableFrom: { git: true, registry: true, path: true, workspace: true, http: false },
         workspaceCapability: null,
     },
     pack: {
@@ -220,7 +220,7 @@ export const EXTENSION_TYPE_TABLE = {
         placement: "container",
         governs: null,
         installInputs: false,
-        installableFrom: { git: true, registry: true, path: true, workspace: true },
+        installableFrom: { git: true, registry: true, path: true, workspace: true, http: false },
         workspaceCapability: null,
     },
 };

package/dist/src/unstable/extensions/installable-types.d.ts

@@ -1,5 +1,5 @@
 import * as Schema from "effect/Schema";
-export declare const installableExtensionTypes: import("./common.js").InstallableFrom<"git" | "workspace" | "registry" | "path">[];
+export declare const installableExtensionTypes: import("./common.js").InstallableFrom<"git" | "workspace" | "registry" | "path" | "http">[];
 export type InstallableExtensionType = (typeof installableExtensionTypes)[number];
 export declare const isInstallableExtensionType: (value: string | undefined) => value is InstallableExtensionType;
 export declare const installableExtensionTypePluralSegments: ("skills" | "mcps" | "subagents" | "rules" | "hooks" | "knowledge" | "packs")[];
@@ -7,6 +7,6 @@ export type InstallableExtensionTypePlural = (typeof installableExtensionTypePlu
 export declare const isInstallableExtensionTypePlural: (value: string | undefined) => value is InstallableExtensionTypePlural;
 export declare const toInstallableExtensionType: (segment: InstallableExtensionTypePlural) => InstallableExtensionType;
 export declare const toInstallableExtensionTypePlural: (type: InstallableExtensionType) => InstallableExtensionTypePlural;
-export declare const InstallableExtensionTypeSchema: Schema.Literals<import("./common.js").InstallableFrom<"git" | "workspace" | "registry" | "path">[]>;
+export declare const InstallableExtensionTypeSchema: Schema.Literals<import("./common.js").InstallableFrom<"git" | "workspace" | "registry" | "path" | "http">[]>;
 export declare const InstallableExtensionTypePluralSchema: Schema.Literals<("skills" | "mcps" | "subagents" | "rules" | "hooks" | "knowledge" | "packs")[]>;
 //# sourceMappingURL=installable-types.d.ts.map

package/dist/src/unstable/extensions/refs/mcp-server.d.ts

@@ -4,16 +4,30 @@
  * @experimental This API is unstable and may change without notice.
  * @packageDocumentation
  */
+import * as Schema from "effect/Schema";
+import type { Handle } from "../handle.js";
+/** Selects one unchanged plugin configuration entry independently from its package. */
+export declare const NativeMcpComponentSchema: Schema.Struct<{
+    readonly format: Schema.Literal<"agent-plugins">;
+    readonly configPath: Schema.NonEmptyString;
+    readonly name: Schema.NonEmptyString;
+}>;
+export type NativeMcpComponent = typeof NativeMcpComponentSchema.Type;
+type ExternalMcpRefDetails<T extends GitHostedRefDetails | LocalRefDetails> = Omit<T, "owner"> & {
+    readonly owner?: Handle;
+    readonly nativeComponent?: NativeMcpComponent;
+};
 import type { McpServerExtensionRefBase, GitHostedRefDetails, RegistryRefDetails, LocalRefDetails, WorkspaceRefDetails } from "./ref-base.js";
 import type { GitBasedSource, RegistrySource, LocalSource, WorkspaceSource } from "../../sources/types.js";
 /** @experimental */
-export type GitHostedMcpServerRef = McpServerExtensionRefBase<"git-hosted", GitBasedSource> & GitHostedRefDetails;
+export type GitHostedMcpServerRef = McpServerExtensionRefBase<"git-hosted", GitBasedSource> & ExternalMcpRefDetails<GitHostedRefDetails>;
 /** @experimental */
 export type RegistryMcpServerRef = McpServerExtensionRefBase<"registry", RegistrySource> & RegistryRefDetails;
 /** @experimental */
-export type LocalMcpServerRef = McpServerExtensionRefBase<"local", LocalSource> & LocalRefDetails;
+export type LocalMcpServerRef = McpServerExtensionRefBase<"local", LocalSource> & ExternalMcpRefDetails<LocalRefDetails>;
 /** @experimental */
 export type WorkspaceMcpServerRef = McpServerExtensionRefBase<"workspace", WorkspaceSource> & WorkspaceRefDetails;
 /** @experimental */
 export type McpServerExtensionRef = GitHostedMcpServerRef | RegistryMcpServerRef | LocalMcpServerRef | WorkspaceMcpServerRef;
+export {};
 //# sourceMappingURL=mcp-server.d.ts.map

package/dist/src/unstable/extensions/refs/mcp-server.js

@@ -4,5 +4,16 @@
  * @experimental This API is unstable and may change without notice.
  * @packageDocumentation
  */
-export {};
+import * as Schema from "effect/Schema";
+/** Selects one unchanged plugin configuration entry independently from its package. */
+export const NativeMcpComponentSchema = Schema.Struct({
+    format: Schema.Literal("agent-plugins"),
+    configPath: Schema.NonEmptyString.check(Schema.makeFilter((value) => /^[A-Za-z]:/u.test(value) ||
+        value.startsWith("/") ||
+        value.includes("\\") ||
+        value.split("/").some((part) => part === "" || part === "..")
+        ? "Expected a package-relative MCP configuration path"
+        : undefined)),
+    name: Schema.NonEmptyString,
+});
 //# sourceMappingURL=mcp-server.js.map

package/dist/src/unstable/extensions/refs/ref-base.d.ts

@@ -10,6 +10,7 @@
  */
 import type { ExtensionName, ExtensionType } from "../common.js";
 import type * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
 import type * as Record from "effect/Record";
 import type { RefType, Source } from "../../sources/types.js";
 import type { PackMemberConstraintMap } from "../common.js";
@@ -20,6 +21,17 @@ import type { WorkspaceScope } from "../../workspace-scope.js";
 import type { SourceHash } from "../../sources/source-hash.js";
 import type { DeprecationView } from "../deprecation.js";
 import type { ArchivalView } from "../archival.js";
+export declare const DistributionDescriptorSchema: Schema.Struct<{
+    readonly format: Schema.Literals<readonly ["agent-plugins", "claude", "codex", "cursor"]>;
+    readonly packageRoot: Schema.String;
+    readonly componentPath: Schema.String;
+    readonly manifestPath: Schema.optionalKey<Schema.String>;
+    readonly marketplace: Schema.optionalKey<Schema.Struct<{
+        readonly path: Schema.String;
+        readonly name: Schema.String;
+    }>>;
+}>;
+export type DistributionDescriptor = typeof DistributionDescriptorSchema.Type;
 /** Ref details for git-hosted sources (GitHub, GitLab, Bitbucket, AzureRepos, Git). @experimental */
 export interface GitHostedRefDetails {
     /** Publisher identity declared by the resolved package manifest. */
@@ -30,6 +42,7 @@ export interface GitHostedRefDetails {
     readonly location: string;
     /** Repository-relative directory selected for this extension */
     readonly sourcePath?: string;
+    readonly distribution?: DistributionDescriptor;
     /** Git tree SHA for integrity verification */
     readonly gitTreeSha: string;
     /** Immutable commit checked out while resolving this ref. */
@@ -70,6 +83,9 @@ export interface LocalRefDetails {
     readonly location: string;
     /** Workspace-relative selected package directory when known. */
     readonly sourcePath?: string;
+    /** Selected member relative to the supplied source directory, before workspace normalization. */
+    readonly sourceRelativePath?: string;
+    readonly distribution?: DistributionDescriptor;
 }
 /** Ref details for intrinsic workspace sources. @experimental */
 export interface WorkspaceRefDetails {
@@ -97,6 +113,7 @@ export type SkillExtensionRefBase<TRefType extends RefType, TSource extends Sour
     readonly skill: {
         readonly name: ExtensionName;
         readonly description: Option.Option<string>;
+        readonly displayName?: string;
         readonly metadata: Option.Option<Record.ReadonlyRecord<string, unknown>>;
     };
 };
@@ -113,8 +130,6 @@ export type SubagentExtensionRefBase<TRefType extends RefType, TSource extends S
         readonly name: ExtensionName;
         readonly description: Option.Option<string>;
     };
-    /** Override platform capability degradation for this extension. */
-    readonly fallback?: "auto" | "none";
 };
 /** @experimental */
 /** @experimental */

package/dist/src/unstable/extensions/refs/ref-base.js

@@ -8,5 +8,20 @@
  * @experimental This API is unstable and may change without notice.
  * @packageDocumentation
  */
-export {};
+import * as Schema from "effect/Schema";
+/** Source-format metadata is kept outside the untouched package payload. */
+const DistributionPathSchema = Schema.String.pipe(Schema.check(Schema.makeFilter((value) => value.length === 0 ||
+    value.includes("\\") ||
+    value.startsWith("/") ||
+    /^[A-Za-z]:/u.test(value) ||
+    value.split("/").some((segment) => segment === ".." || segment.length === 0)
+    ? "Expected a contained package-relative path"
+    : undefined)));
+export const DistributionDescriptorSchema = Schema.Struct({
+    format: Schema.Literals(["agent-plugins", "claude", "codex", "cursor"]),
+    packageRoot: DistributionPathSchema,
+    componentPath: DistributionPathSchema,
+    manifestPath: Schema.optionalKey(DistributionPathSchema),
+    marketplace: Schema.optionalKey(Schema.Struct({ path: DistributionPathSchema, name: Schema.String })),
+});
 //# sourceMappingURL=ref-base.js.map

package/dist/src/unstable/extensions/refs/skill.d.ts

@@ -1,3 +1,6 @@
+import type { HttpArtifactSnapshot } from "../../sources/http-artifact.js";
+import type { DistributionDescriptor } from "./ref-base.js";
+import type { ExtensionName } from "../common.js";
 /**
  * Skill extension ref types.
  *
@@ -8,7 +11,7 @@
  * @packageDocumentation
  */
 import type { SkillExtensionRefBase, GitHostedRefDetails, RegistryRefDetails, LocalRefDetails, WorkspaceRefDetails } from "./ref-base.js";
-import type { GitBasedSource, RegistrySource, LocalSource, WorkspaceSource } from "../../sources/types.js";
+import type { GitBasedSource, HttpSource, RegistrySource, LocalSource, WorkspaceSource } from "../../sources/types.js";
 import type { Handle } from "../handle.js";
 type ExternalSkillRefDetails<TDetails extends GitHostedRefDetails | LocalRefDetails> = Omit<TDetails, "owner"> & {
     readonly owner?: Handle;
@@ -23,6 +26,15 @@ export type LocalSkillRef = SkillExtensionRefBase<"local", LocalSource> & Extern
 /** @experimental */
 export type WorkspaceSkillRef = SkillExtensionRefBase<"workspace", WorkspaceSource> & WorkspaceRefDetails;
 /** @experimental */
-export type SkillExtensionRef = GitHostedSkillRef | RegistrySkillRef | LocalSkillRef | WorkspaceSkillRef;
+export type HttpSkillRef = SkillExtensionRefBase<"http", HttpSource> & {
+    readonly name: ExtensionName;
+    readonly owner?: Handle;
+    readonly portable: boolean;
+    readonly location: string;
+    readonly sourcePath: string;
+    readonly distribution?: DistributionDescriptor;
+    readonly snapshot: HttpArtifactSnapshot;
+};
+export type SkillExtensionRef = HttpSkillRef | GitHostedSkillRef | RegistrySkillRef | LocalSkillRef | WorkspaceSkillRef;
 export {};
 //# sourceMappingURL=skill.d.ts.map

package/dist/src/unstable/extensions/refs/skill.js

@@ -1,11 +1,2 @@
-/**
- * Skill extension ref types.
- *
- * Concrete ref types for skill extensions, built on the shared
- * ExtensionRefBase and ref detail interfaces.
- *
- * @experimental This API is unstable and may change without notice.
- * @packageDocumentation
- */
 export {};
 //# sourceMappingURL=skill.js.map