@agentxm/extension-model 0.29.2 → 0.30.1

package/dist/src/unstable/agent-capabilities/catalog.js

@@ -3,7 +3,6 @@
  *
  * @experimental This API is unstable and may change without notice.
  */
-import * as Schema from "effect/Schema";
 import { adalAgent, aiderDeskAgent, ampAgent, antigravityCliAgent, antigravityAgent, augmentAgent, chatgptAgent, claudeAiAgent, claudeCodeAgent, clineAgent, codeartsAgentAgent, codebuddyAgent, codemakerAgent, codestudioAgent, codexAgent, commandCodeAgent, continueAgent, cortexAgent, coworkAgent, crushAgent, cursorAgent, deepagentsAgent, devinAgent, dextoAgent, droidAgent, firebenderAgent, forgecodeAgent, geminiCliAgent, geminiAppAgent, githubCopilotCliAgent, gooseAgent, grokCliAgent, hermesAgent, ibmBobAgent, iflowCliAgent, junieAgent, lingmaAgent, kiloAgent, kimiCliAgent, kiroCliAgent, kodeAgent, mcpjamAgent, minimaxCodeAgent, mistralVibeAgent, muxAgent, neovateAgent, openclawAgent, opencodeAgent, openhandsAgent, onaAgent, piAgent, pochiAgent, qoderAgent, qoderCnAgent, qwenCodeAgent, replitAgent, rooAgent, rovodevAgent, tabnineCliAgent, traeCnAgent, traeAgent, warpAgent, windsurfAgent, zencoderAgent, zedAgent, zenflowAgent, } from "./data/agents/index.js";
 const defineCatalog = (entries) => entries;
 /** @experimental This API is unstable and may change without notice. */
@@ -72,71 +71,6 @@ export const CONFIGURABLE_AGENTS_BY_ID = defineCatalog({
     zenflow: zenflowAgent,
 });
 /** @experimental This API is unstable and may change without notice. */
-export const CONFIGURABLE_AGENT_IDS = [
-    "adal",
-    "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",
-];
-/** @experimental This API is unstable and may change without notice. */
 export const HOSTED_AGENTS_BY_ID = defineCatalog({
     chatgpt: chatgptAgent,
     "claude-ai": claudeAiAgent,
@@ -144,29 +78,10 @@ export const HOSTED_AGENTS_BY_ID = defineCatalog({
     "gemini-app": geminiAppAgent,
 });
 /** @experimental This API is unstable and may change without notice. */
-export const HOSTED_AGENT_IDS = [
-    "chatgpt",
-    "claude-ai",
-    "cowork",
-    "gemini-app",
-];
-/** @experimental This API is unstable and may change without notice. */
 export const AGENTS_BY_ID = defineCatalog({
     ...CONFIGURABLE_AGENTS_BY_ID,
     ...HOSTED_AGENTS_BY_ID,
 });
 /** @experimental This API is unstable and may change without notice. */
-export const AGENT_IDS = [
-    ...CONFIGURABLE_AGENT_IDS,
-    ...HOSTED_AGENT_IDS,
-];
-/** @experimental This API is unstable and may change without notice. */
-export const AgentIdSchema = Schema.Literals(AGENT_IDS).annotate({
-    identifier: "AgentId",
-    title: "Agent ID",
-    description: "Verified coding agent identifier in the capability catalog.",
-    examples: ["claude-code", "codex", "cursor"],
-});
-/** @experimental This API is unstable and may change without notice. */
 export const AGENTS = Object.values(AGENTS_BY_ID);
 //# sourceMappingURL=catalog.js.map

package/dist/src/unstable/agent-capabilities/derive.d.ts

@@ -108,8 +108,8 @@ export interface HookPortabilityVerdict {
 export declare const canonicalCoverage: (agent: Agent) => {
     events: readonly ("session.start" | "prompt.submit" | "turn.end" | "tool.pre" | "tool.post" | "subagent.stop" | "compaction.pre")[];
     tools: readonly ("file.read" | "file.write" | "file.edit" | "shell.exec" | "web.fetch" | "mcp.call")[];
-    mechanism: readonly ("command-stdin" | "raw")[];
-    matcherKinds: readonly ("regex" | "literal-list" | "glob" | "tool-category" | "exact-substring" | "none-imperative")[];
+    mechanism: readonly ("raw" | "command-stdin")[];
+    matcherKinds: readonly ("regex" | "glob" | "literal-list" | "tool-category" | "exact-substring" | "none-imperative")[];
     decision: ({
         readonly kind: "observe";
     } | {

package/dist/src/unstable/agent-capabilities/derive.js

@@ -4,7 +4,8 @@
  * @experimental This API is unstable and may change without notice.
  */
 import { PER_AGENT_EXTENSION_TYPES } from "../extensions/common.js";
-import { AGENTS, CONFIGURABLE_AGENT_IDS } from "./catalog.js";
+import { AGENTS } from "./catalog.js";
+import { CONFIGURABLE_AGENT_IDS } from "./identity.js";
 import { LEAF_EXTENSION_TYPES } from "../extension-types/schema.js";
 import { SUPPORTED_AXM_SUPPORT, } from "./schema.js";
 import {} from "../extensions/common.js";

package/dist/src/unstable/agent-capabilities/identity.d.ts

@@ -0,0 +1,17 @@
+/** Published coding-agent identities, independent of capability data and adapters. */
+import * as Schema from "effect/Schema";
+/** @experimental This API is unstable and may change without notice. */
+export declare const CONFIGURABLE_AGENT_IDS: readonly ["adal", "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"];
+/** @experimental This API is unstable and may change without notice. */
+export type ConfigurableAgentId = (typeof CONFIGURABLE_AGENT_IDS)[number];
+/** @experimental This API is unstable and may change without notice. */
+export declare const HOSTED_AGENT_IDS: readonly ["chatgpt", "claude-ai", "cowork", "gemini-app"];
+/** @experimental This API is unstable and may change without notice. */
+export type HostedAgentId = (typeof HOSTED_AGENT_IDS)[number];
+/** @experimental This API is unstable and may change without notice. */
+export declare const AGENT_IDS: readonly ["adal", "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", "chatgpt", "claude-ai", "cowork", "gemini-app"];
+/** @experimental This API is unstable and may change without notice. */
+export type AgentId = (typeof AGENT_IDS)[number];
+/** @experimental This API is unstable and may change without notice. */
+export declare const AgentIdSchema: Schema.Literals<readonly ["adal", "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", "chatgpt", "claude-ai", "cowork", "gemini-app"]>;
+//# sourceMappingURL=identity.d.ts.map

package/dist/src/unstable/agent-capabilities/identity.js

@@ -0,0 +1,79 @@
+/** Published coding-agent identities, independent of capability data and adapters. */
+import * as Schema from "effect/Schema";
+/** @experimental This API is unstable and may change without notice. */
+export const CONFIGURABLE_AGENT_IDS = [
+    "adal",
+    "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",
+];
+/** @experimental This API is unstable and may change without notice. */
+export const HOSTED_AGENT_IDS = ["chatgpt", "claude-ai", "cowork", "gemini-app"];
+/** @experimental This API is unstable and may change without notice. */
+export const AGENT_IDS = [...CONFIGURABLE_AGENT_IDS, ...HOSTED_AGENT_IDS];
+/** @experimental This API is unstable and may change without notice. */
+export const AgentIdSchema = Schema.Literals(AGENT_IDS).annotate({
+    identifier: "AgentId",
+    title: "Agent ID",
+    description: "Verified coding agent identifier in the capability catalog.",
+    examples: ["claude-code", "codex", "cursor"],
+});
+//# sourceMappingURL=identity.js.map

package/dist/src/unstable/agent-capabilities/index.d.ts

@@ -10,6 +10,7 @@ export { type PerAgentType } from "../extensions/common.js";
 export { STANDARDS } from "../extension-types/standards.js";
 export { CAPABILITY_VERIFICATION_BUDGET_DAYS, capabilityVerificationAgeReport, type AgentCapabilitySlot, type CapabilityVerificationAge, } from "./verification.js";
 export { agentCapabilityStatus, agentSupportsType, axmIntegrationStatus, canonicalCoverage, deriveAgentDescriptor, deriveSkillConvention, deriveHookPortability, getSupportedAgentsForExtension, getSupportedAgentsForExtensionType, getSupportedAgentsForExtensionTypes, getSupportedExtensionTypesForAgent, isCapabilitySupported, isLeafExtensionType, listCapabilities, installable, toNativeAgent, type AgentCapabilityStatus, type AxmIntegrationStatus, type CapabilityListing, type ExtensionCompatibilityInput, type HookDecisionKind, type HookDecisionRequirement, type HookInstallabilityVerdict, type HookInstallBinding, type HookPortabilityRequirement, type HookPortabilityVerdict, type NativeAgent, type NativeAgentCapabilities, } from "./derive.js";
-export { AGENTS, AGENTS_BY_ID, AGENT_IDS, AgentIdSchema, CONFIGURABLE_AGENTS_BY_ID, CONFIGURABLE_AGENT_IDS, HOSTED_AGENTS_BY_ID, HOSTED_AGENT_IDS, type AgentId, type ConfigurableAgentId, type HostedAgentId, } from "./catalog.js";
+export { AGENTS, AGENTS_BY_ID, CONFIGURABLE_AGENTS_BY_ID, HOSTED_AGENTS_BY_ID } from "./catalog.js";
+export { AGENT_IDS, AgentIdSchema, CONFIGURABLE_AGENT_IDS, HOSTED_AGENT_IDS, type AgentId, type ConfigurableAgentId, type HostedAgentId, } from "./identity.js";
 export { agentById } from "./lookup.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/unstable/agent-capabilities/index.js

@@ -10,6 +10,7 @@ export {} from "../extensions/common.js";
 export { STANDARDS } from "../extension-types/standards.js";
 export { CAPABILITY_VERIFICATION_BUDGET_DAYS, capabilityVerificationAgeReport, } from "./verification.js";
 export { agentCapabilityStatus, agentSupportsType, axmIntegrationStatus, canonicalCoverage, deriveAgentDescriptor, deriveSkillConvention, deriveHookPortability, getSupportedAgentsForExtension, getSupportedAgentsForExtensionType, getSupportedAgentsForExtensionTypes, getSupportedExtensionTypesForAgent, isCapabilitySupported, isLeafExtensionType, listCapabilities, installable, toNativeAgent, } from "./derive.js";
-export { AGENTS, AGENTS_BY_ID, AGENT_IDS, AgentIdSchema, CONFIGURABLE_AGENTS_BY_ID, CONFIGURABLE_AGENT_IDS, HOSTED_AGENTS_BY_ID, HOSTED_AGENT_IDS, } from "./catalog.js";
+export { AGENTS, AGENTS_BY_ID, CONFIGURABLE_AGENTS_BY_ID, HOSTED_AGENTS_BY_ID } from "./catalog.js";
+export { AGENT_IDS, AgentIdSchema, CONFIGURABLE_AGENT_IDS, HOSTED_AGENT_IDS, } from "./identity.js";
 export { agentById } from "./lookup.js";
 //# sourceMappingURL=index.js.map

package/dist/src/unstable/agent-capabilities/lookup.d.ts

@@ -3,7 +3,7 @@
  *
  * @experimental This API is unstable and may change without notice.
  */
-import { type AgentId } from "./catalog.js";
+import { type AgentId } from "./identity.js";
 import type { Agent } from "./schema.js";
 /** @experimental This API is unstable and may change without notice. */
 export declare const agentById: (id: AgentId) => Agent;

package/dist/src/unstable/agent-capabilities/lookup.js

@@ -4,6 +4,7 @@
  * @experimental This API is unstable and may change without notice.
  */
 import { AGENTS_BY_ID } from "./catalog.js";
+import {} from "./identity.js";
 /** @experimental This API is unstable and may change without notice. */
 export const agentById = (id) => AGENTS_BY_ID[id];
 //# sourceMappingURL=lookup.js.map

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

@@ -5,7 +5,7 @@
  * @packageDocumentation
  */
 import type { Record } from "effect";
-import { CONFIGURABLE_AGENT_IDS, type ConfigurableAgentId } from "../agent-capabilities/catalog.js";
+import { CONFIGURABLE_AGENT_IDS, type ConfigurableAgentId } from "../agent-capabilities/identity.js";
 import type { DetectionMarker, Scope, ScopeDetection, SkillReadPath } from "../agent-capabilities/schema.js";
 /**
  * Skills-specific configuration for an agent.

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

@@ -4,7 +4,7 @@
  * @experimental This API is unstable and may change without notice.
  * @packageDocumentation
  */
-import { CONFIGURABLE_AGENT_IDS } from "../agent-capabilities/catalog.js";
+import { CONFIGURABLE_AGENT_IDS, } from "../agent-capabilities/identity.js";
 // -----------------------------------------------------------------------------
 // Agent Identifiers
 // -----------------------------------------------------------------------------

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

@@ -5,7 +5,7 @@
  */
 import * as Schema from "effect/Schema";
 import * as Option from "effect/Option";
-import { AgentIdSchema } from "../agent-capabilities/catalog.js";
+import { AgentIdSchema } from "../agent-capabilities/identity.js";
 /**
  * Author information for a manifest.
  *
@@ -512,7 +512,7 @@ export declare const NonPackManifestFields: {
 };
 /**
  * Agent identifier enumeration for supported coding agents: the single
- * definition lives in the capability catalog.
+ * definition lives in the agent identity module.
  *
  * @experimental This API is unstable and may change without notice.
  */

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

@@ -7,8 +7,7 @@ import * as EffectRecord from "effect/Record";
 import * as Schema from "effect/Schema";
 import * as Option from "effect/Option";
 import * as Result from "effect/Result";
-import { AgentIdSchema } from "../agent-capabilities/catalog.js";
-import { CONFIGURABLE_AGENT_IDS } from "../agents/types.js";
+import { AgentIdSchema, CONFIGURABLE_AGENT_IDS } from "../agent-capabilities/identity.js";
 import { HANDLE_PATTERN_SOURCE, HandleSchema } from "./handle.js";
 import { parseLicenseExpression } from "./license.js";
 import { CompanionPackageSchema } from "../package-urls/index.js";
@@ -577,7 +576,7 @@ export const NonPackManifestFields = {
 };
 /**
  * Agent identifier enumeration for supported coding agents: the single
- * definition lives in the capability catalog.
+ * definition lives in the agent identity module.
  *
  * @experimental This API is unstable and may change without notice.
  */

package/dist/src/unstable/version-constraints/version-selection.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Select a published extension release from domain facts.
+ *
+ * An exact request may select a yanked release; a range selects the highest
+ * non-yanked release it admits. Transport metadata and consumer-specific
+ * admission policies are outside this algorithm.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Option from "effect/Option";
+import type * as DateTime from "effect/DateTime";
+import { type VersionEntryLike } from "./version-constraints.js";
+/** The release facts needed for selection, independent of index serialization. */
+export interface ReleasedVersion extends VersionEntryLike {
+    readonly yankedAt?: DateTime.Utc | undefined;
+}
+/**
+ * Select the highest non-yanked version, independent of index order.
+ */
+export declare const selectVersion: <T extends ReleasedVersion>(versions: ReadonlyArray<T>) => Option.Option<T>;
+/**
+ * Resolve an optional exact version or range against an index: an exact
+ * version matches even when yanked; a range excludes yanked versions.
+ */
+export declare const resolveVersionEntry: <T extends ReleasedVersion>(versions: ReadonlyArray<T>, versionRange: Option.Option<string>) => Option.Option<T>;
+//# sourceMappingURL=version-selection.d.ts.map

package/dist/src/unstable/version-constraints/version-selection.js

@@ -0,0 +1,39 @@
+/**
+ * Select a published extension release from domain facts.
+ *
+ * An exact request may select a yanked release; a range selects the highest
+ * non-yanked release it admits. Transport metadata and consumer-specific
+ * admission policies are outside this algorithm.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Option from "effect/Option";
+import * as semver from "semver";
+import { resolveVersionInRange } from "./version-constraints.js";
+/**
+ * Select the highest non-yanked version, independent of index order.
+ */
+export const selectVersion = (versions) => {
+    const availableVersions = versions.filter((entry) => entry.yankedAt === undefined);
+    return resolveVersionInRange(availableVersions, Option.none());
+};
+/**
+ * Resolve an optional exact version or range against an index: an exact
+ * version matches even when yanked; a range excludes yanked versions.
+ */
+export const resolveVersionEntry = (versions, versionRange) => {
+    if (Option.isNone(versionRange)) {
+        return selectVersion(versions);
+    }
+    if (semver.valid(versionRange.value) === versionRange.value) {
+        return Option.fromUndefinedOr(versions.find((candidate) => candidate.version === versionRange.value));
+    }
+    const availableVersions = versions.filter((entry) => entry.yankedAt === undefined);
+    const resolved = resolveVersionInRange(availableVersions, versionRange);
+    if (Option.isNone(resolved)) {
+        return Option.none();
+    }
+    return Option.fromUndefinedOr(availableVersions.find((candidate) => candidate.version === resolved.value.version));
+};
+//# sourceMappingURL=version-selection.js.map