@agentxm/workspace-state 0.28.4 → 0.28.6

package/dist/src/index.d.ts

@@ -32,7 +32,7 @@ export { computeSkillPathsForLayout, type SkillPathSource, type SkillDirPaths, }
 export { ArtifactChangeSchema, type ArtifactChange } from "./workspace/artifact-change.js";
 export { ConfiguredAgentOutcomeSchema, type ConfiguredAgentOutcome, } from "./workspace/configured-agent-outcome.js";
 export { ConfiguredAgentOutcomesProvider, ConfiguredAgentOutcomesUnavailable, type ConfiguredAgentOutcomesFailureCategory, type ConfiguredAgentOutcomesForState, type ConfiguredAgentOutcomesProviderService, } from "./workspace/configured-agent-outcomes-provider.js";
-export { AXM_MCP_METADATA_KEY, AxmMcpMetadataSchema, isAxmManagedMcpEntry, isMcpServerApplicableToAgent, readAxmMcpMetadata, type AxmMcpMetadata, } from "./workspace/mcp-entry-semantics.js";
+export { AXM_MCP_METADATA_KEY, AxmMcpMetadataSchema, isAxmManagedMcpEntry, readAxmMcpMetadata, type AxmMcpMetadata, } from "./workspace/mcp-entry-semantics.js";
 export { resolveProjectWorkspaceLayout, resolveProjectWorkspaceStatePaths, resolveUserWorkspaceLayout, type WorkspaceLayout, } from "./workspace/layout.js";
 export { AXM_DIR_NAME, USER_WORKSPACE_DIRECTORY, getProjectRuntimeDir, locateWorkspace, resolveUserAxmHome, resolveUserAxmHomePure, resolveUserHome, resolveUserWorkspaceRoot, resolveUserWorkspaceRootPure, type WorkspaceLocation, } from "./workspace/paths.js";
 export { removeIfExists } from "./workspace/remove-if-exists.js";
@@ -54,6 +54,7 @@ export { hookLockEntryToRef, knowledgeLockEntryToRef, mcpServerLockEntryToRef, p
 export { lockEntryToSourceParams, printSkillLockSourceLocator, } from "./workspace/lock-entry-to-source-params.js";
 export { sourceToLockEntry, type SourceToLockEntryInput, } from "./workspace/source-to-lock-entry.js";
 export { deriveSourceMetaFromLockType, type SourceMeta } from "./workspace/source-metadata.js";
+export { mcpRegistryResolutionKey, mcpResolutionKey } from "./workspace/mcp-source-identity.js";
 export { READ_MODEL_EXTENSION_FAMILY_BY_TYPE, makeWorkspaceReadModel, WorkspaceReadModelConfig, type RawSourceBytes, type ScopedOwnerApi, type ScopedSourceHostsApi, type ScopedStateApi, type WorkspaceReadModel, type WorkspaceReadModelConfigService, } from "./workspace/read-model/service.js";
 export { AgentRootResolver, AgentRootResolverLive, } from "./workspace/read-model/agent-root-resolver.js";
 export { ExtensionInventoryClassificationSchema, ExtensionInventoryLifecycleSchema, ExtensionInventoryRowSchema, ExtensionInventorySchema, projectExtensionInventory, type ExtensionInventory, type ExtensionInventoryClassification, type ExtensionInventoryLifecycle, type ExtensionInventoryObservation, type ExtensionInventoryRow, type LifecycleInventoryCandidate, type ProjectExtensionInventoryInput, } from "./workspace/read-model/extensions/inventory.js";
@@ -62,7 +63,7 @@ export type { ActualMcpServer, ActualPack, ActualSkill, ActualSubagent, Installe
 export type { FileSpec, FixtureSpec, ScopeFiles, TreeFiles, } from "./workspace/read-model/__fixtures__/builder.js";
 export { WorkspaceMutations, type MakeWorkspaceTransactionCapabilities, type WorkspaceMutationsService, type WorkspaceMutationsError, type WorkspaceMutationsOptions, type WorkspaceSettingsReadFailure, type WorkspaceLockfileReadFailure, type WorkspaceStateReadFailure, type WorkspaceSettingsMutationFailure, type WorkspaceLockfileMutationFailure, type WorkspaceStateMutationFailure, type SetSkillArgs, type SetPackArgs, type SetMcpServerArgs, type SetSubagentArgs, type PackDirPath, type ExtensionTarget, type ExtensionTargetFor, type LockfileState, type WorkspaceTransactionRunner, type WorkspaceTransactionCapabilities, type WorkspaceTransitionAcquirer, type WorkspaceTransitionRequest, type WorkspaceLifecycleTransactionArgs, type SkillExtensionTarget, type PackExtensionTarget, type McpServerExtensionTarget, type SubagentExtensionTarget, type RuleExtensionTarget, type HookExtensionTarget, type KnowledgeExtensionTarget, } from "./workspace/service-interface.js";
 export { makeWorkspaceMutations, type WorkspaceLayerOptions } from "./workspace/service.js";
-export { LockfileDecodeError, LockfileIoError, LockfileParseError, SettingsDecodeError, SettingsIoError, SettingsParseError, SkillDiscoveryRootInvalid, SubagentScanFailed, WorkspaceRootEscape, type LockfileReadError, type SettingsReadError, } from "./workspace/read-model/errors.js";
+export { LockfileDecodeError, LockfileIoError, LockfileParseError, LockfileVersionUnsupported, SettingsDecodeError, SettingsIoError, SettingsParseError, SkillDiscoveryRootInvalid, SubagentScanFailed, WorkspaceRootEscape, type LockfileReadError, type SettingsReadError, } from "./workspace/read-model/errors.js";
 export { AcceptedResolutionMissing, CanonicalPathRemovalError, DesiredPackGraphIncomplete, InlineExtensionSourceMissing, InvalidAgentId, LockedSkillMissing, LockEntryEndpointConflict, LockEntryNameInvalid, LockEntrySourceMissing, LockEntrySourceTypeConflict, LockEntryUrlInvalid, PackageContentHashFailed, SettingsEntryMissing, SupersededCanonicalRemovalFailed, SymlinkCreationError, WorkspaceLayoutError, WorkspaceNotInitialized, WorkspaceSourceInvalid, } from "./workspace/errors.js";
 export { CurrentWorkspaceClosure, CurrentWorkspaceTransaction, protectCreatedAncestors, protectInContext, protectWorkspacePath, readPendingClosureRestorationFailures, type Snapshot, type WorkspaceTransactionContext, TransitionLockError, TransitionLockUnavailable, WorkspaceDirectoryError, WorkspaceRestorationError, WorkspaceRestorationIncomplete, WorkspaceSnapshotError, WorkspaceTransitionCompromised, type TransitionContention, type TransitionLockHolder, type WorkspaceTransactionFailure, type WorkspaceTransitionAcquireFailure, } from "./workspace/transaction.js";
 export { setupScopeSupport, setupScopeSupportOutcomes, type SetupScopeSupportCategory, type SetupScopeSupportOutcome, type SetupScopeSupportReasonCode, type SetupScopeSupportStatus, } from "./workspace/setup-scope-support.js";

package/dist/src/index.js

@@ -39,7 +39,7 @@ export { ArtifactChangeSchema } from "./workspace/artifact-change.js";
 export { ConfiguredAgentOutcomeSchema, } from "./workspace/configured-agent-outcome.js";
 export { ConfiguredAgentOutcomesProvider, ConfiguredAgentOutcomesUnavailable, } from "./workspace/configured-agent-outcomes-provider.js";
 // MCP entry settings semantics
-export { AXM_MCP_METADATA_KEY, AxmMcpMetadataSchema, isAxmManagedMcpEntry, isMcpServerApplicableToAgent, readAxmMcpMetadata, } from "./workspace/mcp-entry-semantics.js";
+export { AXM_MCP_METADATA_KEY, AxmMcpMetadataSchema, isAxmManagedMcpEntry, readAxmMcpMetadata, } from "./workspace/mcp-entry-semantics.js";
 // Layout and paths
 export { resolveProjectWorkspaceLayout, resolveProjectWorkspaceStatePaths, resolveUserWorkspaceLayout, } from "./workspace/layout.js";
 export { AXM_DIR_NAME, USER_WORKSPACE_DIRECTORY, getProjectRuntimeDir, locateWorkspace, resolveUserAxmHome, resolveUserAxmHomePure, resolveUserHome, resolveUserWorkspaceRoot, resolveUserWorkspaceRootPure, } from "./workspace/paths.js";
@@ -67,6 +67,7 @@ export { lockEntryToSourceParams, printSkillLockSourceLocator, } from "./workspa
 export { sourceToLockEntry, } from "./workspace/source-to-lock-entry.js";
 // Source metadata
 export { deriveSourceMetaFromLockType } from "./workspace/source-metadata.js";
+export { mcpRegistryResolutionKey, mcpResolutionKey } from "./workspace/mcp-source-identity.js";
 // Workspace read model
 export { READ_MODEL_EXTENSION_FAMILY_BY_TYPE, makeWorkspaceReadModel, WorkspaceReadModelConfig, } from "./workspace/read-model/service.js";
 export { AgentRootResolver, AgentRootResolverLive, } from "./workspace/read-model/agent-root-resolver.js";
@@ -76,7 +77,7 @@ export { getPriorityDirectories, parsePluginManifests, scanAgentSubagentFiles, s
 export { WorkspaceMutations, } from "./workspace/service-interface.js";
 export { makeWorkspaceMutations } from "./workspace/service.js";
 // Read-model per-source typed failure families
-export { LockfileDecodeError, LockfileIoError, LockfileParseError, SettingsDecodeError, SettingsIoError, SettingsParseError, SkillDiscoveryRootInvalid, SubagentScanFailed, WorkspaceRootEscape, } from "./workspace/read-model/errors.js";
+export { LockfileDecodeError, LockfileIoError, LockfileParseError, LockfileVersionUnsupported, SettingsDecodeError, SettingsIoError, SettingsParseError, SkillDiscoveryRootInvalid, SubagentScanFailed, WorkspaceRootEscape, } from "./workspace/read-model/errors.js";
 // Workspace-state typed failure families
 export { AcceptedResolutionMissing, CanonicalPathRemovalError, DesiredPackGraphIncomplete, InlineExtensionSourceMissing, InvalidAgentId, LockedSkillMissing, LockEntryEndpointConflict, LockEntryNameInvalid, LockEntrySourceMissing, LockEntrySourceTypeConflict, LockEntryUrlInvalid, PackageContentHashFailed, SettingsEntryMissing, SupersededCanonicalRemovalFailed, SymlinkCreationError, WorkspaceLayoutError, WorkspaceNotInitialized, WorkspaceSourceInvalid, } from "./workspace/errors.js";
 // Workspace transaction registration (the WS half of the transaction seam)

package/dist/src/lockfile/lockfile.d.ts

@@ -173,7 +173,7 @@ export declare const commitLockfileUpdates: (axmDir: string, lockfile: Lockfile,
             readonly treeIntegrity: string & import("effect/Brand").Brand<"TreeIntegrity">;
         };
     };
-    readonly lockfileVersion: 6;
+    readonly lockfileVersion: 7;
     readonly knowledge?: {
         readonly [x: string]: {
             readonly type: "github";
@@ -913,7 +913,7 @@ export declare const commitLockfileSnapshotUpdateAtPath: (lockfilePath: string,
             readonly treeIntegrity: string & import("effect/Brand").Brand<"TreeIntegrity">;
         };
     };
-    readonly lockfileVersion: 6;
+    readonly lockfileVersion: 7;
     readonly knowledge?: {
         readonly [x: string]: {
             readonly type: "github";
@@ -1642,7 +1642,7 @@ export declare const commitLockfileSnapshotUpdate: (axmDir: string, base: Lockfi
             readonly treeIntegrity: string & import("effect/Brand").Brand<"TreeIntegrity">;
         };
     };
-    readonly lockfileVersion: 6;
+    readonly lockfileVersion: 7;
     readonly knowledge?: {
         readonly [x: string]: {
             readonly type: "github";

package/dist/src/lockfile/schema.d.ts

@@ -4,13 +4,13 @@
  * The lockfile (axm-lock.yaml) records accepted immutable resolutions for
  * externally sourced extensions.
  *
- * Lockfile v6 is authority, not receipt history. It contains no authored,
+ * Lockfile v7 is authority, not receipt history. It contains no authored,
  * bundled, inline, projection, completion-time, or command-history state.
  *
  * @experimental This API is unstable and may change without notice.
  */
 import * as Schema from "effect/Schema";
-export declare const LOCKFILE_VERSION = 6;
+export declare const LOCKFILE_VERSION = 7;
 /**
  * Lock entry for a single installed skill.
  * Discriminated union by the `type` field.
@@ -667,7 +667,8 @@ export declare const McpServerLockEntrySchema: Schema.Union<readonly [Schema.Str
  */
 export type McpServerLockEntry = Schema.Schema.Type<typeof McpServerLockEntrySchema>;
 /**
- * Map of MCP server names to their lock entries.
+ * Map of canonical MCP source-resolution identities to their lock entries.
+ * Local connection names live only in settings and native projections.
  *
  * @experimental This API is unstable and may change without notice.
  */
@@ -2339,7 +2340,7 @@ export declare const LOCK_ENTRY_SCHEMA_BY_TYPE: {
     }>]>;
 };
 export declare const LockfileSchema: Schema.Struct<{
-    readonly lockfileVersion: Schema.Literal<6>;
+    readonly lockfileVersion: Schema.Literal<7>;
     readonly skills: Schema.$Record<Schema.String, Schema.Union<readonly [Schema.Struct<{
         readonly type: Schema.Literal<"github">;
         readonly sourceType: Schema.Literal<"github">;

package/dist/src/lockfile/schema.js

@@ -4,7 +4,7 @@
  * The lockfile (axm-lock.yaml) records accepted immutable resolutions for
  * externally sourced extensions.
  *
- * Lockfile v6 is authority, not receipt history. It contains no authored,
+ * Lockfile v7 is authority, not receipt history. It contains no authored,
  * bundled, inline, projection, completion-time, or command-history state.
  *
  * @experimental This API is unstable and may change without notice.
@@ -16,7 +16,7 @@ import { TreeIntegritySchema } from "../workspace/materialized-tree.js";
 import { ExtensionNameSchema } from "@agentxm/extension-model/unstable/extensions/common";
 import { VersionSchema } from "@agentxm/extension-model/unstable/version-constraints";
 import { SourceNamespaceSchema, SourceRefSchema, SourceSegmentSchema, SourceSubPathSchema, } from "@agentxm/extension-model/unstable/sources/types";
-export const LOCKFILE_VERSION = 6;
+export const LOCKFILE_VERSION = 7;
 // =============================================================================
 // Flat Source Schemas (discriminated by type field)
 // =============================================================================
@@ -234,7 +234,8 @@ export const McpServerLockEntrySchema = makeSourceLockUnion("mcp-server", Handle
 // MCP Servers Lock Map
 // =============================================================================
 /**
- * Map of MCP server names to their lock entries.
+ * Map of canonical MCP source-resolution identities to their lock entries.
+ * Local connection names live only in settings and native projections.
  *
  * @experimental This API is unstable and may change without notice.
  */
@@ -379,7 +380,7 @@ export const LOCK_ENTRY_SCHEMA_BY_TYPE = {
  * enabling reproducible installations across environments.
  *
  * Structure:
- * - lockfileVersion: Schema version (currently 6)
+ * - lockfileVersion: Schema version (currently 7)
  * - skills: Map of skill names to their lock entries
  * - packs: Map of pack names to their lock entries (optional)
  *

package/dist/src/settings/schema.d.ts

@@ -268,7 +268,6 @@ export declare const McpServerEntryObjectSchema: Schema.Struct<{
     readonly source: Schema.NonEmptyString;
     readonly enabled: Schema.optionalKey<Schema.Boolean>;
     readonly env: Schema.optionalKey<Schema.Union<readonly [Schema.$Record<Schema.String, Schema.String>, Schema.$Array<Schema.String>]>>;
-    readonly agents: Schema.optionalKey<Schema.$Array<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"]>>>;
 }>;
 /**
  * Union of MCP server entry forms: plain source string or object with source + enabled + env.
@@ -287,7 +286,6 @@ export declare const McpServerEntrySchema: Schema.decodeTo<Schema.Union<readonly
     readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
     readonly enabled: Schema.Boolean;
     readonly env: Schema.$Record<Schema.String, Schema.String>;
-    readonly agents: Schema.optional<Schema.$Array<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"]>>>;
 }>, Schema.Struct<{
     readonly kind: Schema.Literal<"inline">;
     readonly source: Schema.optional<Schema.Never>;
@@ -297,7 +295,6 @@ export declare const McpServerEntrySchema: Schema.decodeTo<Schema.Union<readonly
     readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
     readonly enabled: Schema.Boolean;
     readonly env: Schema.$Record<Schema.String, Schema.String>;
-    readonly agents: Schema.optional<Schema.$Array<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"]>>>;
 }>]>, Schema.Union<readonly [Schema.String, Schema.Struct<{
     readonly source: Schema.optionalKey<Schema.NonEmptyString>;
     readonly command: Schema.optionalKey<Schema.NonEmptyString>;
@@ -306,7 +303,6 @@ export declare const McpServerEntrySchema: Schema.decodeTo<Schema.Union<readonly
     readonly headers: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
     readonly enabled: Schema.optionalKey<Schema.Boolean>;
     readonly env: Schema.optionalKey<Schema.Union<readonly [Schema.$Record<Schema.String, Schema.String>, Schema.$Array<Schema.String>]>>;
-    readonly agents: Schema.optionalKey<Schema.$Array<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"]>>>;
 }>]>, never, never>;
 /**
  * Inferred type for McpServerEntry schema.
@@ -336,7 +332,6 @@ export declare const McpServersMapSchema: Schema.$Record<Schema.String, Schema.d
     readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
     readonly enabled: Schema.Boolean;
     readonly env: Schema.$Record<Schema.String, Schema.String>;
-    readonly agents: Schema.optional<Schema.$Array<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"]>>>;
 }>, Schema.Struct<{
     readonly kind: Schema.Literal<"inline">;
     readonly source: Schema.optional<Schema.Never>;
@@ -346,7 +341,6 @@ export declare const McpServersMapSchema: Schema.$Record<Schema.String, Schema.d
     readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
     readonly enabled: Schema.Boolean;
     readonly env: Schema.$Record<Schema.String, Schema.String>;
-    readonly agents: Schema.optional<Schema.$Array<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"]>>>;
 }>]>, Schema.Union<readonly [Schema.String, Schema.Struct<{
     readonly source: Schema.optionalKey<Schema.NonEmptyString>;
     readonly command: Schema.optionalKey<Schema.NonEmptyString>;
@@ -355,7 +349,6 @@ export declare const McpServersMapSchema: Schema.$Record<Schema.String, Schema.d
     readonly headers: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
     readonly enabled: Schema.optionalKey<Schema.Boolean>;
     readonly env: Schema.optionalKey<Schema.Union<readonly [Schema.$Record<Schema.String, Schema.String>, Schema.$Array<Schema.String>]>>;
-    readonly agents: Schema.optionalKey<Schema.$Array<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"]>>>;
 }>]>, never, never>>;
 /**
  * Inferred type for McpServersMap schema.
@@ -643,7 +636,6 @@ export declare const SettingsSchema: Schema.StructWithRest<Schema.Struct<{
         readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
         readonly enabled: Schema.Boolean;
         readonly env: Schema.$Record<Schema.String, Schema.String>;
-        readonly agents: Schema.optional<Schema.$Array<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"]>>>;
     }>, Schema.Struct<{
         readonly kind: Schema.Literal<"inline">;
         readonly source: Schema.optional<Schema.Never>;
@@ -653,7 +645,6 @@ export declare const SettingsSchema: Schema.StructWithRest<Schema.Struct<{
         readonly headers: Schema.optional<Schema.$Record<Schema.String, Schema.String>>;
         readonly enabled: Schema.Boolean;
         readonly env: Schema.$Record<Schema.String, Schema.String>;
-        readonly agents: Schema.optional<Schema.$Array<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"]>>>;
     }>]>, Schema.Union<readonly [Schema.String, Schema.Struct<{
         readonly source: Schema.optionalKey<Schema.NonEmptyString>;
         readonly command: Schema.optionalKey<Schema.NonEmptyString>;
@@ -662,7 +653,6 @@ export declare const SettingsSchema: Schema.StructWithRest<Schema.Struct<{
         readonly headers: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
         readonly enabled: Schema.optionalKey<Schema.Boolean>;
         readonly env: Schema.optionalKey<Schema.Union<readonly [Schema.$Record<Schema.String, Schema.String>, Schema.$Array<Schema.String>]>>;
-        readonly agents: Schema.optionalKey<Schema.$Array<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"]>>>;
     }>]>, never, never>>]>>;
     readonly mcpServersConfig: Schema.optionalKey<Schema.Struct<{
         readonly dir: Schema.optionalKey<Schema.NonEmptyString>;

package/dist/src/settings/schema.js

@@ -169,12 +169,6 @@ const McpServerEnvSchema = Schema.Union([
     title: "MCP Server Env",
     description: "MCP environment values as a map or pass-through variable names. Array entries decode to ${VAR} references.",
 });
-const McpServerAgentsSchema = Schema.Array(ConfigurableAgentIdSchema)
-    .annotate({
-    description: "Coding agents this MCP server applies to. Omit to target every configured agent.",
-    examples: [["claude-code", "codex"]],
-})
-    .check(Schema.isMinLength(1), Schema.isUnique());
 const decodeMcpEnv = (env) => {
     if (env === undefined)
         return {};
@@ -465,7 +459,6 @@ export const McpServerEntryObjectSchema = Schema.Struct({
     source: entrySourceFieldSchema("MCP server", "mcps"),
     enabled: enabledFieldSchema,
     env: Schema.optionalKey(McpServerEnvSchema),
-    agents: Schema.optionalKey(McpServerAgentsSchema),
 }).annotate({
     title: "MCP Server Entry Object",
     description: "An MCP server entry with source and optional enabled/env fields.",
@@ -489,7 +482,6 @@ const McpServerVerboseEntryObjectSchema = Schema.Struct({
     })),
     enabled: enabledFieldSchema,
     env: Schema.optionalKey(McpServerEnvSchema),
-    agents: Schema.optionalKey(McpServerAgentsSchema),
 }).pipe(Schema.check(Schema.makeFilter((entry) => validateMcpTransportExclusivity(entry))));
 /**
  * Union of MCP server entry forms: plain source string or object with source + enabled + env.
@@ -509,7 +501,6 @@ export const McpServerEntrySchema = compactOrVerboseEntry(McpServerVerboseEntryO
         headers: Schema.optional(Schema.Record(Schema.String, Schema.String)),
         enabled: Schema.Boolean,
         env: Schema.Record(Schema.String, Schema.String),
-        agents: Schema.optional(Schema.Array(ConfigurableAgentIdSchema)),
     }),
     Schema.Struct({
         kind: Schema.Literal("inline"),
@@ -520,7 +511,6 @@ export const McpServerEntrySchema = compactOrVerboseEntry(McpServerVerboseEntryO
         headers: Schema.optional(Schema.Record(Schema.String, Schema.String)),
         enabled: Schema.Boolean,
         env: Schema.Record(Schema.String, Schema.String),
-        agents: Schema.optional(Schema.Array(ConfigurableAgentIdSchema)),
     }),
 ]), {
     decode: (entry) => typeof entry === "string"
@@ -531,7 +521,6 @@ export const McpServerEntrySchema = compactOrVerboseEntry(McpServerVerboseEntryO
                 source: entry.source,
                 enabled: entry.enabled ?? true,
                 env: decodeMcpEnv(entry.env),
-                ...(entry.agents === undefined ? {} : { agents: entry.agents }),
             }
             : {
                 kind: "inline",
@@ -541,13 +530,9 @@ export const McpServerEntrySchema = compactOrVerboseEntry(McpServerVerboseEntryO
                 ...(entry.headers === undefined ? {} : { headers: entry.headers }),
                 enabled: entry.enabled ?? true,
                 env: decodeMcpEnv(entry.env),
-                ...(entry.agents === undefined ? {} : { agents: entry.agents }),
             },
     encode: (entry) => {
-        if (entry.kind !== "inline" &&
-            entry.enabled &&
-            Object.keys(entry.env).length === 0 &&
-            entry.agents === undefined) {
+        if (entry.kind !== "inline" && entry.enabled && Object.keys(entry.env).length === 0) {
             return entry.source;
         }
         const obj = {};
@@ -568,14 +553,11 @@ export const McpServerEntrySchema = compactOrVerboseEntry(McpServerVerboseEntryO
             obj.enabled = false;
         if (Object.keys(entry.env).length > 0)
             obj.env = entry.env;
-        if (entry.agents !== undefined)
-            obj.agents = entry.agents;
         if (entry.kind !== "inline") {
             return {
                 source: entry.source,
                 ...(obj.enabled === undefined ? {} : { enabled: obj.enabled }),
                 ...(obj.env === undefined ? {} : { env: obj.env }),
-                ...(obj.agents === undefined ? {} : { agents: obj.agents }),
             };
         }
         if (entry.command !== undefined) {
@@ -584,7 +566,6 @@ export const McpServerEntrySchema = compactOrVerboseEntry(McpServerVerboseEntryO
                 ...(obj.args === undefined ? {} : { args: obj.args }),
                 ...(obj.enabled === undefined ? {} : { enabled: obj.enabled }),
                 ...(obj.env === undefined ? {} : { env: obj.env }),
-                ...(obj.agents === undefined ? {} : { agents: obj.agents }),
             };
         }
         return {
@@ -592,7 +573,6 @@ export const McpServerEntrySchema = compactOrVerboseEntry(McpServerVerboseEntryO
             ...(obj.headers === undefined ? {} : { headers: obj.headers }),
             ...(obj.enabled === undefined ? {} : { enabled: obj.enabled }),
             ...(obj.env === undefined ? {} : { env: obj.env }),
-            ...(obj.agents === undefined ? {} : { agents: obj.agents }),
         };
     },
 }, {
@@ -606,7 +586,6 @@ export const McpServerEntrySchema = compactOrVerboseEntry(McpServerVerboseEntryO
             command: "npx",
             args: ["-y", "linear-mcp-server"],
             env: ["LINEAR_API_KEY"],
-            agents: ["claude-code"],
         },
         { url: "https://mcp.sentry.dev/sse", headers: { Authorization: "Bearer ${SENTRY_TOKEN}" } },
     ],

package/dist/src/workspace/accepted-canonical-ref.d.ts

@@ -9,7 +9,7 @@ import type { WorkspaceSnapshotError } from "./transaction.js";
 import { type LockEntryToRefError } from "./lock-entry-to-ref.js";
 import { type AcceptedExtensionResolution, type CanonicalObservation } from "./canonical-observation.js";
 import type { DesiredExtensionNode } from "./desired-state-graph.js";
-import type { WorkspaceLockfileReadFailure, WorkspaceMutationsService, WorkspaceStateReadFailure } from "./service-interface.js";
+import type { WorkspaceMutationsService, WorkspaceStateReadFailure } from "./service-interface.js";
 interface AcceptedCanonicalRefArgs {
     readonly workspace: WorkspaceMutationsService;
     readonly type: DesiredExtensionNode["type"];
@@ -34,7 +34,7 @@ export interface UsableAcceptedCanonical extends UsableAcceptedCanonicalObservat
 /** Canonical package AXM may delete when removing desired state. Authored source is durable. */
 export declare const removableAcceptedCanonicalPath: (canonical: Option.Option<AcceptedCanonicalObservation>) => Option.Option<string>;
 /** Exact acquired canonical path reconstructed directly from accepted lock authority. */
-export declare const acceptedLockedCanonicalPath: (args: AcceptedCanonicalRefArgs) => Effect.Effect<Option.Option<string>, WorkspaceLockfileReadFailure, Path.Path>;
+export declare const acceptedLockedCanonicalPath: (args: AcceptedCanonicalRefArgs) => Effect.Effect<Option.Option<string>, WorkspaceStateReadFailure, Path.Path>;
 /**
  * Capture exact cleanup for a superseded accepted package. The old path is
  * read before the lock transition; the returned effect runs afterward and
@@ -42,7 +42,7 @@ export declare const acceptedLockedCanonicalPath: (args: AcceptedCanonicalRefArg
  */
 export declare const prepareAcceptedCanonicalTransition: (args: AcceptedCanonicalRefArgs & {
     readonly ref: ExtensionRef;
-}) => Effect.Effect<Effect.Effect<void, WorkspaceSnapshotError | SupersededCanonicalRemovalFailed>, WorkspaceLockfileReadFailure, FileSystem.FileSystem | Path.Path>;
+}) => Effect.Effect<Effect.Effect<void, WorkspaceSnapshotError | SupersededCanonicalRemovalFailed>, WorkspaceStateReadFailure, FileSystem.FileSystem | Path.Path>;
 /** Reconstruct a ref directly from accepted lock authority without desired reachability. */
 export declare const acceptedLockedResolutionRef: (args: AcceptedCanonicalRefArgs) => Effect.Effect<Option.Option<ExtensionRef>, AcceptedCanonicalRefError, FileSystem.FileSystem | Path.Path>;
 /**

package/dist/src/workspace/accepted-canonical-ref.js

@@ -21,7 +21,7 @@ const getAcceptedResolution = (workspace, type, name) => {
             case "skill":
                 return workspace.getLockedSkill(name);
             case "mcp-server":
-                return workspace.getLockedMcpServer(name);
+                return workspace.getLockedMcpServerForConnection(name);
             case "subagent":
                 return workspace.getLockedSubagent(name);
             case "rule":
@@ -101,7 +101,7 @@ const refFromAcceptedResolution = (workspace, type, name) => Effect.gen(function
             });
         }
         case "mcp-server": {
-            const entry = yield* workspace.getLockedMcpServer(name);
+            const entry = yield* workspace.getLockedMcpServerForConnection(name);
             return yield* Option.match(entry, {
                 onNone: () => Effect.fail(missingAccepted("MCP", name)),
                 onSome: (value) => mcpServerLockEntryToRef(name, value, deps),

package/dist/src/workspace/canonical-observation.js

@@ -19,6 +19,7 @@ import { printSourceParams } from "@agentxm/extension-model/unstable/sources/pri
 import { lockEntryToSourceParams } from "./lock-entry-to-source-params.js";
 import { collectDesiredConstraintContributors, } from "./desired-state-graph.js";
 import { computeExtensionPathsForLayout, extensionPathSourceFromLockEntry, } from "./extension-paths.js";
+import { mcpResolutionKey } from "./mcp-source-identity.js";
 const MANIFEST_CONTRACTS = {
     skill: { filename: "skill.json", schema: SkillManifestSchema },
     "mcp-server": { filename: "mcp.json", schema: McpServerManifestSchema },
@@ -100,11 +101,13 @@ export const observeCanonicalExtension = ({ layout, desired, accepted, }) => Eff
             status: "missing-resolution",
         };
     }
-    const acceptedIdentity = accepted?.type === "registry"
-        ? `${accepted.owner}/${toExtensionTypePlural(desired.type)}/${accepted.name}`
-        : accepted === undefined
-            ? undefined
-            : printSourceParams(lockEntryToSourceParams(accepted));
+    const acceptedIdentity = accepted?.extensionType === "mcp-server"
+        ? mcpResolutionKey(accepted)
+        : accepted?.type === "registry"
+            ? `${accepted.owner}/${toExtensionTypePlural(desired.type)}/${accepted.name}`
+            : accepted === undefined
+                ? undefined
+                : printSourceParams(lockEntryToSourceParams(accepted));
     if (!workspaceAuthored &&
         !bundled &&
         acceptedIdentity !== desired.identity &&

package/dist/src/workspace/configured-agent-outcomes.d.ts

@@ -43,6 +43,5 @@ export declare const configuredAgentLifecycleOutcomes: (args: {
     readonly targetState: "enabled" | "disabled" | "absent";
     readonly installed: boolean;
     readonly observedAgentIds?: ReadonlyArray<string>;
-    readonly applicableAgentIds?: ReadonlyArray<string>;
 }) => ReadonlyArray<ConfiguredAgentOutcome>;
 //# sourceMappingURL=configured-agent-outcomes.d.ts.map

package/dist/src/workspace/configured-agent-outcomes.js

@@ -32,7 +32,6 @@ const unsupportedOutcome = (args) => ({
 export const configuredAgentLifecycleOutcomes = (args) => {
     const policy = EXTENSION_CONFIGURED_AGENT_POLICY[args.type];
     const observed = new Set(args.observedAgentIds ?? []);
-    const applicable = args.applicableAgentIds === undefined ? undefined : new Set(args.applicableAgentIds);
     if (policy.kind === "not-applicable") {
         return args.agentIds.map((agentId) => ({
             extensionType: args.type,
@@ -57,16 +56,6 @@ export const configuredAgentLifecycleOutcomes = (args) => {
                     : "The extension is disabled, so no agent projection is expected.",
             };
         }
-        if (applicable !== undefined && !applicable.has(agentId)) {
-            return {
-                extensionType: args.type,
-                name: args.name,
-                agentId,
-                outcome: "not-applicable",
-                reasonCode: "target-policy-excluded",
-                reason: `${agentId} is excluded by the extension target policy.`,
-            };
-        }
         const support = supportByAgent.get(agentId);
         if (support === undefined) {
             return unsupportedOutcome({

package/dist/src/workspace/desired-state-graph.d.ts

@@ -7,12 +7,14 @@ import type { Settings } from "../settings/index.js";
 import { type WorkspaceLayout } from "./layout.js";
 export type DesiredExtensionOrigin = {
     readonly type: "settings";
+    readonly localName?: string;
     readonly authority?: "sourced";
     readonly source: string;
     readonly enabled: boolean;
     readonly constraint?: string;
 } | {
     readonly type: "settings";
+    readonly localName?: string;
     readonly authority: "inline";
     readonly source?: undefined;
     readonly constraint?: undefined;
@@ -52,6 +54,7 @@ export interface DesiredConstraintContributor {
     readonly range: string;
     readonly location: string;
     readonly dependingPack?: string;
+    readonly localName?: string;
 }
 export type DesiredStateProblem = {
     readonly type: "workspace-owner-missing";
@@ -98,8 +101,15 @@ export type DesiredStateProblem = {
 export interface DesiredStateGraph {
     readonly complete: boolean;
     readonly nodes: ReadonlyArray<DesiredExtensionNode>;
+    readonly mcpSourceClosures: ReadonlyArray<DesiredMcpSourceClosure>;
     readonly problems: ReadonlyArray<DesiredStateProblem>;
 }
+export interface DesiredMcpSourceClosure {
+    readonly identity: string;
+    readonly localNames: ReadonlyArray<string>;
+    readonly constraints: ReadonlyArray<string>;
+    readonly origins: ReadonlyArray<DesiredExtensionOrigin>;
+}
 export type ProspectivePackRef = Pick<PackRef, "owner" | "pack" | "version">;
 interface DesiredStateGraphArgs {
     readonly baseDir: string;
@@ -107,8 +117,10 @@ interface DesiredStateGraphArgs {
     readonly layout?: WorkspaceLayout;
     /** Resolved Pack roots whose manifests supersede the currently materialized copy. */
     readonly prospectivePacks?: ReadonlyArray<ProspectivePackRef>;
+    /** Registry source aliases mapped to their stable authority endpoints. */
+    readonly registryAuthorities?: Readonly<Record<string, URL | string>>;
 }
 export declare const collectDesiredConstraintContributors: (_path: Path.Path, origins: ReadonlyArray<DesiredExtensionOrigin>) => ReadonlyArray<DesiredConstraintContributor>;
-export declare const buildDesiredStateGraph: ({ baseDir, settings, layout, prospectivePacks, }: DesiredStateGraphArgs) => Effect.Effect<DesiredStateGraph, never, FileSystem.FileSystem | Path.Path>;
+export declare const buildDesiredStateGraph: ({ baseDir, settings, layout, prospectivePacks, registryAuthorities, }: DesiredStateGraphArgs) => Effect.Effect<DesiredStateGraph, never, FileSystem.FileSystem | Path.Path>;
 export {};
 //# sourceMappingURL=desired-state-graph.d.ts.map