@agentxm/workspace-state 0.28.11 → 0.28.13

package/dist/src/index.d.ts

@@ -3,9 +3,11 @@
  *
  * The workspace-state kernel: settings and lockfile authority, the workspace
  * read model, desired-state and canonical-observation vocabulary, extension
- * paths and layout, and the `WorkspaceMutations` service contract. Extension
- * ref and source vocabulary lives in `@agentxm/extension-model`; plan
- * execution and workspace transactions live in
+ * paths and layout, and the narrow workspace-state services (`WorkspaceLocation`,
+ * readers, writers) with the transitional `WorkspaceMutations` facade over
+ * them. Extension ref and source vocabulary lives in
+ * `@agentxm/extension-model`; workspace transactions live in
+ * `@agentxm/workspace-transactions`; plan execution in
  * `@agentxm/workspace-operations`.
  *
  * @experimental This API is unstable and may change without notice.
@@ -15,7 +17,7 @@ export * from "./settings/index.js";
 export * from "./lockfile/index.js";
 export * from "./schema/index.js";
 export { resolveKnowledgeDiscoveryConfig, type ResolvedKnowledgeDiscoveryConfig, } from "./knowledge/discovery-config.js";
-export { isPathSafe, safeChildPath, validatePathSafety, PathTraversalDetected, } from "./utils/path-safety.js";
+export { safeChildPath, validatePathSafety, PathTraversalDetected } from "./utils/path-safety.js";
 export { SETTINGS_KNOWN_KEYS } from "./settings/schema.js";
 export { gitSourceLockFields } from "./lockfile/entry-fields.js";
 export { LOCK_ENTRY_SCHEMA_BY_TYPE } from "./lockfile/schema.js";
@@ -29,19 +31,20 @@ export { computePackPathsForLayout } from "./workspace/pack-paths.js";
 export { computePackManifestContentIdentity } from "./workspace/pack-manifest-content-identity.js";
 export { MaterializedFileTargetSchema, type MaterializedFileTarget, } from "./workspace/materialized-file-target.js";
 export { computeSkillPathsForLayout, type SkillPathSource, type SkillDirPaths, } from "./workspace/skill-paths.js";
+export { computeSubagentPathsForLayout, subagentContentFilename, subagentContentPath, type SubagentDirPaths, type SubagentPathSource, } from "./workspace/subagent-paths.js";
+export { enabledConfiguredEntries, isConfiguredEntryEnabled, type ConfiguredEntryEnabledState, } from "./workspace/configured-entry.js";
 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, 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 { AXM_DIR_NAME, USER_WORKSPACE_DIRECTORY, getProjectRuntimeDir, locateWorkspace, resolveUserAxmHome, resolveUserAxmHomePure, resolveUserHome, resolveUserWorkspaceRoot, resolveUserWorkspaceRootPure, type LocatedWorkspace, } from "./workspace/paths.js";
 export { removeIfExists } from "./workspace/remove-if-exists.js";
 export { createSymlink, type SymlinkResult } from "./workspace/create-symlink.js";
-export { userScopeRefusal, type UserScopedExtension } from "./workspace/scope-refusal.js";
 export { configuredRecordRows, configuredRowsByName, installedRecordRows, installedRowsByName, isConfiguredRecordRow, isInstalledRecordRow, isUnmanagedRecordRow, recordRowsByName, unmanagedRecordRows, unmanagedRowsByName, type ConfiguredRecordRow, type ImplicitRecordRow, type InstalledRecordRow, type UnmanagedRecordRow, } from "./workspace/read-model-record-rows.js";
 export type { ReadModelRecordRow, PackagingKind } from "./workspace/read-model-record-types.js";
 export { getKnowledgeLockEntries, getLockedEntries, lockEntryVersion, type AnyLockEntry, type AnyLockMap, } from "./workspace/locked-entries.js";
 export { buildDesiredStateGraph, isInlineDesiredExtension, isSourcedDesiredExtension, type DesiredExtensionNode, type DesiredExtensionOrigin, type DesiredConstraintContributor, type DesiredStateGraph, type DesiredStateProblem, type ProspectivePackRef, } from "./workspace/desired-state-graph.js";
+export { decodeDesiredExtensionIdentity, type DecodedDesiredExtensionIdentity, type DesiredPackageAuthority, } from "./workspace/desired-identity.js";
 export { desiredStateProblemText, desiredStateProblemsText, } from "./workspace/desired-state-problem-text.js";
 export { isDesiredExtensionActive, type DesiredStateEnabledOrigin, } from "./workspace/desired-state-enabled.js";
 export { validateDesiredPackLock } from "./workspace/desired-pack-lock.js";
@@ -49,7 +52,6 @@ export { observeCanonicalExtension, canonicalPathForAcceptedExtension, type Acce
 export { acceptedResolutionRef, acceptedLockedResolutionRef, acceptedLockedCanonicalPath, prepareAcceptedCanonicalTransition, acceptedCanonicalObservation, removableAcceptedCanonicalPath, usableAcceptedCanonical, usableAcceptedCanonicalObservation, usableAcceptedCanonicalRef, type AcceptedCanonicalObservation, type AcceptedCanonicalRefError, type UsableAcceptedCanonical, type UsableAcceptedCanonicalObservation, } from "./workspace/accepted-canonical-ref.js";
 export { isObservedInstalled } from "./workspace/observed-installed.js";
 export { resolveWorkspaceExtensionRef } from "./workspace/configured-entry-resolution/workspace-ref.js";
-export { type ConfiguredEntryFailureReason, type ConfiguredRegistryResolution, type ResolvedConfiguredEntry, type ResolvedConfiguredHook, type ResolvedConfiguredKnowledge, type ResolvedConfiguredMcpServer, type ResolvedConfiguredPack, type ResolvedConfiguredRule, type ResolvedConfiguredSkill, type ResolvedConfiguredSubagent, } from "./workspace/configured-entry-resolution/types.js";
 export { hookLockEntryToRef, knowledgeLockEntryToRef, mcpServerLockEntryToRef, packLockEntryToRef, ruleLockEntryToRef, skillLockEntryToRef, subagentLockEntryToRef, type LockEntrySourceLookupError, type LockEntryToRefError, } from "./workspace/lock-entry-to-ref.js";
 export { lockEntryToSourceParams, printSkillLockSourceLocator, } from "./workspace/lock-entry-to-source-params.js";
 export { sourceToLockEntry, type SourceToLockEntryInput, } from "./workspace/source-to-lock-entry.js";
@@ -61,13 +63,20 @@ export { ExtensionInventoryClassificationSchema, ExtensionInventoryLifecycleSche
 export { getPriorityDirectories, parsePluginManifests, scanAgentSubagentFiles, scanAllSubagentFiles, skillsInDir, type AgentSubagentSummary, type DetectedSubagentFile, type DiscoveredSkill, type DiscoveryOptions, } from "./workspace/read-model/discovery/index.js";
 export type { ActualMcpServer, ActualPack, ActualSkill, ActualSubagent, InstalledHook, InstalledKnowledgeBundle, InstalledMcpServer, InstalledPack, InstalledRule, InstalledSkill, InstalledSubagent, UnmanagedMcpServer, } from "./workspace/read-model/extensions/index.js";
 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 { WorkspaceLocation, type WorkspaceLocationService } from "./workspace/location.js";
+export { SettingsReader, type SettingsReaderService } from "./workspace/settings-reader.js";
+export { LockfileReader, type LockfileReaderService } from "./workspace/lockfile-reader.js";
+export { readOtherScopeState, type OtherScopeState } from "./workspace/other-scope-reader.js";
+export { DesiredStateReader, type DesiredStateReaderService, } from "./workspace/desired-state-reader.js";
+export { WorkspaceRecords, type WorkspaceRecordsService } from "./workspace/workspace-records.js";
+export { ExtensionPaths, type ExtensionPathsService } from "./workspace/extension-paths-service.js";
+export { SettingsWriter, type SettingsWriterService } from "./workspace/settings-writer.js";
+export { AcceptedResolutionWriter, type AcceptedResolutionWriterService, } from "./workspace/accepted-resolution-writer.js";
+export { DesiredStateWriter, type DeclareArgsByType, type DesiredStateWriterService, } from "./workspace/desired-state-writer.js";
+export type { LockEntriesOf, LockEntryByType, SettingsEntriesOf, SettingsEntryByType, } from "./workspace/entry-accessors.js";
+export { WorkspaceMutations, 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 SetRuleArgs, type SetHookArgs, type SetKnowledgeArgs, type PackDirPath, type ExtensionTarget, type ExtensionTargetFor, type LockfileState, type SkillExtensionTarget, type PackExtensionTarget, type McpServerExtensionTarget, type SubagentExtensionTarget, type RuleExtensionTarget, type HookExtensionTarget, type KnowledgeExtensionTarget, } from "./workspace/service-interface.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";
 export { configuredAgentLifecycleOutcomes, EXTENSION_CONFIGURED_AGENT_POLICY, type ConfiguredAgentLifecycleState, } from "./workspace/configured-agent-outcomes.js";
-export { FootprintRecorder, makeFootprintRecorder, readFootprint, recordFootprint, type FootprintObservation, } from "./workspace/footprint-recorder.js";
-export { AgentPresenceProbe, AgentPresenceUnavailable, type AgentPresenceProbeService, } from "./workspace/read-model/agent-presence.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.js

@@ -3,9 +3,11 @@
  *
  * The workspace-state kernel: settings and lockfile authority, the workspace
  * read model, desired-state and canonical-observation vocabulary, extension
- * paths and layout, and the `WorkspaceMutations` service contract. Extension
- * ref and source vocabulary lives in `@agentxm/extension-model`; plan
- * execution and workspace transactions live in
+ * paths and layout, and the narrow workspace-state services (`WorkspaceLocation`,
+ * readers, writers) with the transitional `WorkspaceMutations` facade over
+ * them. Extension ref and source vocabulary lives in
+ * `@agentxm/extension-model`; workspace transactions live in
+ * `@agentxm/workspace-transactions`; plan execution in
  * `@agentxm/workspace-operations`.
  *
  * @experimental This API is unstable and may change without notice.
@@ -18,7 +20,7 @@ export * from "./schema/index.js";
 // Knowledge discovery configuration
 export { resolveKnowledgeDiscoveryConfig, } from "./knowledge/discovery-config.js";
 // Path safety
-export { isPathSafe, safeChildPath, validatePathSafety, PathTraversalDetected, } from "./utils/path-safety.js";
+export { safeChildPath, validatePathSafety, PathTraversalDetected } from "./utils/path-safety.js";
 // Additional settings and lockfile vocabulary consumed beyond the barrels
 export { SETTINGS_KNOWN_KEYS } from "./settings/schema.js";
 export { gitSourceLockFields } from "./lockfile/entry-fields.js";
@@ -34,33 +36,32 @@ export { computePackPathsForLayout } from "./workspace/pack-paths.js";
 export { computePackManifestContentIdentity } from "./workspace/pack-manifest-content-identity.js";
 export { MaterializedFileTargetSchema, } from "./workspace/materialized-file-target.js";
 export { computeSkillPathsForLayout, } from "./workspace/skill-paths.js";
+export { computeSubagentPathsForLayout, subagentContentFilename, subagentContentPath, } from "./workspace/subagent-paths.js";
+export { enabledConfiguredEntries, isConfiguredEntryEnabled, } from "./workspace/configured-entry.js";
 // Plan-facing workspace vocabulary
 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, 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";
 // Managed filesystem primitives
 export { removeIfExists } from "./workspace/remove-if-exists.js";
 export { createSymlink } from "./workspace/create-symlink.js";
-// Scope refusal
-export { userScopeRefusal } from "./workspace/scope-refusal.js";
 // Read-model record rows + lifecycle views
 export { configuredRecordRows, configuredRowsByName, installedRecordRows, installedRowsByName, isConfiguredRecordRow, isInstalledRecordRow, isUnmanagedRecordRow, recordRowsByName, unmanagedRecordRows, unmanagedRowsByName, } from "./workspace/read-model-record-rows.js";
 export { getKnowledgeLockEntries, getLockedEntries, lockEntryVersion, } from "./workspace/locked-entries.js";
 export { buildDesiredStateGraph, isInlineDesiredExtension, isSourcedDesiredExtension, } from "./workspace/desired-state-graph.js";
+// The source-qualified identity a desired-graph node carries, decoded.
+export { decodeDesiredExtensionIdentity, } from "./workspace/desired-identity.js";
 export { desiredStateProblemText, desiredStateProblemsText, } from "./workspace/desired-state-problem-text.js";
 export { isDesiredExtensionActive, } from "./workspace/desired-state-enabled.js";
 export { validateDesiredPackLock } from "./workspace/desired-pack-lock.js";
 export { observeCanonicalExtension, canonicalPathForAcceptedExtension, } from "./workspace/canonical-observation.js";
 export { acceptedResolutionRef, acceptedLockedResolutionRef, acceptedLockedCanonicalPath, prepareAcceptedCanonicalTransition, acceptedCanonicalObservation, removableAcceptedCanonicalPath, usableAcceptedCanonical, usableAcceptedCanonicalObservation, usableAcceptedCanonicalRef, } from "./workspace/accepted-canonical-ref.js";
 export { isObservedInstalled } from "./workspace/observed-installed.js";
-// Configured entry vocabulary (resolution policy lives in extension-lifecycle)
+// Configured entry vocabulary (resolution policy lives in extension-resolution)
 export { resolveWorkspaceExtensionRef } from "./workspace/configured-entry-resolution/workspace-ref.js";
-export {} from "./workspace/configured-entry-resolution/types.js";
 // Lock entry translation
 export { hookLockEntryToRef, knowledgeLockEntryToRef, mcpServerLockEntryToRef, packLockEntryToRef, ruleLockEntryToRef, skillLockEntryToRef, subagentLockEntryToRef, } from "./workspace/lock-entry-to-ref.js";
 export { lockEntryToSourceParams, printSkillLockSourceLocator, } from "./workspace/lock-entry-to-source-params.js";
@@ -73,17 +74,25 @@ export { READ_MODEL_EXTENSION_FAMILY_BY_TYPE, makeWorkspaceReadModel, WorkspaceR
 export { AgentRootResolver, AgentRootResolverLive, } from "./workspace/read-model/agent-root-resolver.js";
 export { ExtensionInventoryClassificationSchema, ExtensionInventoryLifecycleSchema, ExtensionInventoryRowSchema, ExtensionInventorySchema, projectExtensionInventory, } from "./workspace/read-model/extensions/inventory.js";
 export { getPriorityDirectories, parsePluginManifests, scanAgentSubagentFiles, scanAllSubagentFiles, skillsInDir, } from "./workspace/read-model/discovery/index.js";
-// Workspace mutation facade
+// Narrow workspace-state services
+export { WorkspaceLocation } from "./workspace/location.js";
+export { SettingsReader } from "./workspace/settings-reader.js";
+export { LockfileReader } from "./workspace/lockfile-reader.js";
+export { readOtherScopeState } from "./workspace/other-scope-reader.js";
+export { DesiredStateReader, } from "./workspace/desired-state-reader.js";
+export { WorkspaceRecords } from "./workspace/workspace-records.js";
+export { ExtensionPaths } from "./workspace/extension-paths-service.js";
+export { SettingsWriter } from "./workspace/settings-writer.js";
+export { AcceptedResolutionWriter, } from "./workspace/accepted-resolution-writer.js";
+export { DesiredStateWriter, } from "./workspace/desired-state-writer.js";
+// TRANSITIONAL workspace mutation facade. No CLI handler composes it any
+// more; the domain packages under packages/core still do, and it is removed
+// when the last of them reads and writes through the narrow services above.
 export { WorkspaceMutations, } from "./workspace/service-interface.js";
-export { makeWorkspaceMutations } from "./workspace/service.js";
 // Read-model per-source typed failure families
 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)
-export { CurrentWorkspaceClosure, CurrentWorkspaceTransaction, protectCreatedAncestors, protectInContext, protectWorkspacePath, readPendingClosureRestorationFailures, TransitionLockError, TransitionLockUnavailable, WorkspaceDirectoryError, WorkspaceRestorationError, WorkspaceRestorationIncomplete, WorkspaceSnapshotError, WorkspaceTransitionCompromised, } from "./workspace/transaction.js";
 export { setupScopeSupport, setupScopeSupportOutcomes, } from "./workspace/setup-scope-support.js";
 export { configuredAgentLifecycleOutcomes, EXTENSION_CONFIGURED_AGENT_POLICY, } from "./workspace/configured-agent-outcomes.js";
-export { FootprintRecorder, makeFootprintRecorder, readFootprint, recordFootprint, } from "./workspace/footprint-recorder.js";
-export { AgentPresenceProbe, AgentPresenceUnavailable, } from "./workspace/read-model/agent-presence.js";
 //# sourceMappingURL=index.js.map

package/dist/src/live.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @agentxm/workspace-state environment-backed composition.
+ *
+ * The workspace-state layers every entry point composes: the resolved
+ * location, the narrow reader and writer services over it, the workspace
+ * transaction scope anchored to its paths, and — transitionally — the
+ * `WorkspaceMutations` facade. Only application composition roots and named
+ * test-support modules import this module; feature logic keeps the services
+ * in its Effect environment.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type * as FileSystem from "effect/FileSystem";
+import * as Layer from "effect/Layer";
+import type * as Path from "effect/Path";
+import { WorkspaceTransactionScope } from "@agentxm/workspace-transactions";
+import { AcceptedResolutionWriter } from "./workspace/accepted-resolution-writer.js";
+import { DesiredStateReader } from "./workspace/desired-state-reader.js";
+import { DesiredStateWriter } from "./workspace/desired-state-writer.js";
+import { ExtensionPaths } from "./workspace/extension-paths-service.js";
+import { LockfileReader } from "./workspace/lockfile-reader.js";
+import { WorkspaceLocation } from "./workspace/location.js";
+import { WorkspaceMutations, type WorkspaceMutationsError, type WorkspaceMutationsOptions } from "./workspace/service-interface.js";
+import { SettingsReader } from "./workspace/settings-reader.js";
+import { SettingsWriter } from "./workspace/settings-writer.js";
+import { WorkspaceRecords } from "./workspace/workspace-records.js";
+export type { WorkspaceMutationsOptions } from "./workspace/service-interface.js";
+/** The resolved location of the selected workspace scope. */
+export declare const WorkspaceLocationLive: (options: WorkspaceMutationsOptions) => Layer.Layer<WorkspaceLocation, WorkspaceMutationsError, FileSystem.FileSystem | Path.Path>;
+/** The narrow reader and writer services over one workspace location. */
+export type WorkspaceStateServices = WorkspaceLocation | SettingsReader | LockfileReader | DesiredStateReader | WorkspaceRecords | ExtensionPaths | SettingsWriter | AcceptedResolutionWriter | DesiredStateWriter;
+/**
+ * Every workspace-state service plus the transitional `WorkspaceMutations`
+ * facade, without a transaction scope. Compose a scope beside it: the
+ * production one from `layer`, or a memory one from `./testing`.
+ */
+export declare const WorkspaceStateLive: (options: WorkspaceMutationsOptions) => Layer.Layer<WorkspaceStateServices | WorkspaceMutations, WorkspaceMutationsError, FileSystem.FileSystem | Path.Path>;
+/** The production transaction scope over the located workspace's paths. */
+export declare const WorkspaceTransactionScopeLive: Layer.Layer<WorkspaceTransactionScope, never, WorkspaceLocation>;
+/**
+ * The composed workspace layer every entry point provides: the state
+ * services, the transitional facade, and the production transaction scope.
+ */
+export declare const layer: (options: WorkspaceMutationsOptions) => Layer.Layer<WorkspaceStateServices | WorkspaceMutations | WorkspaceTransactionScope, WorkspaceMutationsError, FileSystem.FileSystem | Path.Path>;
+//# sourceMappingURL=live.d.ts.map

package/dist/src/live.js

@@ -0,0 +1,60 @@
+/**
+ * @agentxm/workspace-state environment-backed composition.
+ *
+ * The workspace-state layers every entry point composes: the resolved
+ * location, the narrow reader and writer services over it, the workspace
+ * transaction scope anchored to its paths, and — transitionally — the
+ * `WorkspaceMutations` facade. Only application composition roots and named
+ * test-support modules import this module; feature logic keeps the services
+ * in its Effect environment.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { WorkspaceTransactionScope } from "@agentxm/workspace-transactions";
+import { AcceptedResolutionWriter, AcceptedResolutionWriterLive, } from "./workspace/accepted-resolution-writer.js";
+import { DesiredStateReader, DesiredStateReaderLive } from "./workspace/desired-state-reader.js";
+import { DesiredStateWriter, DesiredStateWriterLive } from "./workspace/desired-state-writer.js";
+import { ExtensionPaths, ExtensionPathsLive } from "./workspace/extension-paths-service.js";
+import { LockfileReader, LockfileReaderLive } from "./workspace/lockfile-reader.js";
+import { WorkspaceLocation, makeWorkspaceLocation } from "./workspace/location.js";
+import { makeWorkspaceMutationsFacade } from "./workspace/service.js";
+import { WorkspaceMutations, } from "./workspace/service-interface.js";
+import { SettingsReader, SettingsReaderLive } from "./workspace/settings-reader.js";
+import { SettingsWriter, SettingsWriterLive } from "./workspace/settings-writer.js";
+import { WorkspaceStateShared, makeWorkspaceStateShared } from "./workspace/shared.js";
+import { WorkspaceRecords, WorkspaceRecordsLive } from "./workspace/workspace-records.js";
+/** The resolved location of the selected workspace scope. */
+export const WorkspaceLocationLive = (options) => Layer.effect(WorkspaceLocation, makeWorkspaceLocation(options));
+const stateServicesOver = (location) => {
+    // The shared mutex and cache are composition-internal: one instance (the
+    // layer is memoized by reference within a build) provided to every service
+    // that needs it and never published to consumers.
+    const shared = Layer.effect(WorkspaceStateShared, makeWorkspaceStateShared);
+    const readers = Layer.provideMerge(Layer.mergeAll(WorkspaceRecordsLive, LockfileReaderLive), Layer.provideMerge(DesiredStateReaderLive, Layer.provideMerge(Layer.provide(SettingsReaderLive, shared), location)));
+    const withPaths = Layer.provideMerge(ExtensionPathsLive, readers);
+    return Layer.provideMerge(Layer.provide(Layer.mergeAll(SettingsWriterLive, AcceptedResolutionWriterLive, DesiredStateWriterLive), shared), withPaths);
+};
+/**
+ * Every workspace-state service plus the transitional `WorkspaceMutations`
+ * facade, without a transaction scope. Compose a scope beside it: the
+ * production one from `layer`, or a memory one from `./testing`.
+ */
+export const WorkspaceStateLive = (options) => 
+// TRANSITIONAL: the facade layer is removed when the last domain package
+// reads and writes through the services.
+Layer.provideMerge(Layer.effect(WorkspaceMutations, makeWorkspaceMutationsFacade), stateServicesOver(WorkspaceLocationLive(options)));
+/** The production transaction scope over the located workspace's paths. */
+export const WorkspaceTransactionScopeLive = Layer.unwrap(Effect.map(WorkspaceLocation, (location) => WorkspaceTransactionScope.layer({
+    workspaceDir: location.runtimeDir,
+    settingsPath: location.settingsPath,
+    lockPath: location.lockPath,
+})));
+/**
+ * The composed workspace layer every entry point provides: the state
+ * services, the transitional facade, and the production transaction scope.
+ */
+export const layer = (options) => Layer.provideMerge(WorkspaceTransactionScopeLive, WorkspaceStateLive(options));
+//# sourceMappingURL=live.js.map

package/dist/src/lockfile/lockfile.js

@@ -14,8 +14,7 @@ import * as Effect from "effect/Effect";
 import * as Schema from "effect/Schema";
 import * as Semaphore from "effect/Semaphore";
 import YAML from "yaml";
-import { recordFootprint } from "../workspace/footprint-recorder.js";
-import { sweepStaleAtomicWriteTemps, writeFileAtomic } from "../utils/atomic-write.js";
+import { recordFootprint, sweepStaleAtomicWriteTemps, writeFileAtomic, } from "@agentxm/workspace-transactions";
 import { LockfileValidationError, LockfileWriteError } from "./errors.js";
 import { LOCKFILE_VERSION, LockfileSchema } from "./schema.js";
 // -----------------------------------------------------------------------------

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

@@ -8,7 +8,7 @@
  * @packageDocumentation
  */
 export type { AzureReposSourceHostConfig, BitbucketSourceHostConfig, GitHubSourceHostConfig, GitLabSourceHostConfig, HookEntry, HooksMap, KnowledgeEntry, KnowledgeConfig, KnowledgeMap, InstructionsConfig, InstructionsConfigValue, McpServerEntry, McpServersMap, MinimumReleaseAge, MinimumReleaseAgeExclude, PackEntry, PacksMap, RegistrySourceHostConfig, RuleEntry, RulesMap, Settings, SkillEntry, SkillsMap, SubagentEntry, SubagentsMap, SourceHostConfig, WorkspacePublishOptions, } from "./schema.js";
-export { HookEntryObjectSchema, HookEntrySchema, HooksMapSchema, KnowledgeEntryObjectSchema, KnowledgeEntrySchema, KnowledgeConfigSchema, KnowledgeMapSchema, InstructionsConfigSchema, McpServerEntryObjectSchema, McpServerEntrySchema, McpServersMapSchema, MinimumReleaseAgeSchema, PackEntryObjectSchema, PackEntrySchema, PacksMapSchema, RuleEntryObjectSchema, RuleEntrySchema, RulesMapSchema, SETTINGS_KEY_ORDER, SettingsSchema, SkillEntryObjectSchema, SkillEntrySchema, SkillsMapSchema, SubagentEntryObjectSchema, SubagentEntrySchema, SubagentsMapSchema, SourceHostConfigSchema, WorkspacePublishOptionsSchema, } from "./schema.js";
+export { DEFAULT_MINIMUM_RELEASE_AGE, DEFAULT_MINIMUM_RELEASE_AGE_DURATION, HookEntryObjectSchema, HookEntrySchema, HooksMapSchema, KnowledgeEntryObjectSchema, KnowledgeEntrySchema, KnowledgeConfigSchema, KnowledgeMapSchema, InstructionsConfigSchema, McpServerEntryObjectSchema, McpServerEntrySchema, McpServersMapSchema, MinimumReleaseAgeSchema, PackEntryObjectSchema, PackEntrySchema, PacksMapSchema, RuleEntryObjectSchema, RuleEntrySchema, RulesMapSchema, SETTINGS_KEY_ORDER, SettingsSchema, SkillEntryObjectSchema, SkillEntrySchema, SkillsMapSchema, SubagentEntryObjectSchema, SubagentEntrySchema, SubagentsMapSchema, SourceHostConfigSchema, WorkspacePublishOptionsSchema, } from "./schema.js";
 export { createDefaultSettings, writeSettingsAtPath } from "./settings.js";
 export { SettingsWriteError } from "./errors.js";
 export type { JsonModification } from "./format-preserving-json.js";

package/dist/src/settings/index.js

@@ -7,7 +7,7 @@
  * @experimental This API is unstable and may change without notice.
  * @packageDocumentation
  */
-export { HookEntryObjectSchema, HookEntrySchema, HooksMapSchema, KnowledgeEntryObjectSchema, KnowledgeEntrySchema, KnowledgeConfigSchema, KnowledgeMapSchema, InstructionsConfigSchema, McpServerEntryObjectSchema, McpServerEntrySchema, McpServersMapSchema, MinimumReleaseAgeSchema, PackEntryObjectSchema, PackEntrySchema, PacksMapSchema, RuleEntryObjectSchema, RuleEntrySchema, RulesMapSchema, SETTINGS_KEY_ORDER, SettingsSchema, SkillEntryObjectSchema, SkillEntrySchema, SkillsMapSchema, SubagentEntryObjectSchema, SubagentEntrySchema, SubagentsMapSchema, SourceHostConfigSchema, WorkspacePublishOptionsSchema, } from "./schema.js";
+export { DEFAULT_MINIMUM_RELEASE_AGE, DEFAULT_MINIMUM_RELEASE_AGE_DURATION, HookEntryObjectSchema, HookEntrySchema, HooksMapSchema, KnowledgeEntryObjectSchema, KnowledgeEntrySchema, KnowledgeConfigSchema, KnowledgeMapSchema, InstructionsConfigSchema, McpServerEntryObjectSchema, McpServerEntrySchema, McpServersMapSchema, MinimumReleaseAgeSchema, PackEntryObjectSchema, PackEntrySchema, PacksMapSchema, RuleEntryObjectSchema, RuleEntrySchema, RulesMapSchema, SETTINGS_KEY_ORDER, SettingsSchema, SkillEntryObjectSchema, SkillEntrySchema, SkillsMapSchema, SubagentEntryObjectSchema, SubagentEntrySchema, SubagentsMapSchema, SourceHostConfigSchema, WorkspacePublishOptionsSchema, } from "./schema.js";
 // Settings I/O
 export { createDefaultSettings, writeSettingsAtPath } from "./settings.js";
 export { SettingsWriteError } from "./errors.js";

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

@@ -5,6 +5,7 @@
  *
  * @experimental This API is unstable and may change without notice.
  */
+import * as Duration from "effect/Duration";
 import * as Schema from "effect/Schema";
 import { ReleaseAgeExcludePatternSchema } from "@agentxm/extension-model/unstable/extensions/fqn-pattern";
 /**
@@ -110,6 +111,17 @@ type EnabledEntryObject = SourceEntryObject & {
 export declare const MinimumReleaseAgeSchema: Schema.String;
 /** @experimental */
 export type MinimumReleaseAge = Schema.Schema.Type<typeof MinimumReleaseAgeSchema>;
+/**
+ * The minimum release age a workspace applies when neither the project nor
+ * the user scope declares one. The value is a workspace-settings default, so
+ * it lives with the settings schema that validates it; resolution policy
+ * reads it through the settings reader.
+ *
+ * @experimental
+ */
+export declare const DEFAULT_MINIMUM_RELEASE_AGE = "24h";
+/** The same default as a duration, for policy that compares against a clock. */
+export declare const DEFAULT_MINIMUM_RELEASE_AGE_DURATION: Duration.Duration;
 /** @experimental */
 export type MinimumReleaseAgeExclude = ReadonlyArray<typeof ReleaseAgeExcludePatternSchema.Type>;
 /**

package/dist/src/settings/schema.js

@@ -5,12 +5,13 @@
  *
  * @experimental This API is unstable and may change without notice.
  */
+import * as Duration from "effect/Duration";
 import * as Schema from "effect/Schema";
 import * as SchemaTransformation from "effect/SchemaTransformation";
 import { ConfigurableAgentIdSchema, ExtensionVisibilitySchema, EXTENSION_NAME_PATTERN, } from "@agentxm/extension-model/unstable/extensions/common";
 import { ReleaseAgeExcludePatternSchema } from "@agentxm/extension-model/unstable/extensions/fqn-pattern";
 import { HandleSchema } from "@agentxm/extension-model/unstable/extensions/handle";
-import { LintConfigSchema } from "@agentxm/registry-protocol/unstable/lint/config";
+import { LintConfigSchema } from "@agentxm/extension-content/lint";
 import { isWorkspaceSourceLocator } from "@agentxm/extension-model/unstable/sources/workspace";
 // -----------------------------------------------------------------------------
 // Source Host Config (array-based, discriminated on `type` field)
@@ -203,6 +204,17 @@ export const MinimumReleaseAgeSchema = Schema.String.check(Schema.isPattern(/^\d
     default: "24h",
     examples: ["24h", "1440m", "0s"],
 });
+/**
+ * The minimum release age a workspace applies when neither the project nor
+ * the user scope declares one. The value is a workspace-settings default, so
+ * it lives with the settings schema that validates it; resolution policy
+ * reads it through the settings reader.
+ *
+ * @experimental
+ */
+export const DEFAULT_MINIMUM_RELEASE_AGE = "24h";
+/** The same default as a duration, for policy that compares against a clock. */
+export const DEFAULT_MINIMUM_RELEASE_AGE_DURATION = Duration.hours(24);
 const compactOrVerboseEntry = (objectSchema, canonicalSchema, transformation, annotations) => Schema.Union([Schema.String, objectSchema])
     .annotate(annotations)
     .pipe(Schema.decodeTo(canonicalSchema, SchemaTransformation.transform(transformation)));

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

@@ -33,6 +33,6 @@ export declare const renderExistingSettings: (priorText: string, prior: Schema.J
  *
  * @experimental This API is unstable and may change without notice.
  */
-export declare const writeSettingsAtPath: (settingsPath: string, settings: Settings) => Effect.Effect<void, SettingsWriteError | import("../workspace/transaction.js").WorkspaceSnapshotError, FileSystem.FileSystem | Path.Path>;
+export declare const writeSettingsAtPath: (settingsPath: string, settings: Settings) => Effect.Effect<void, SettingsWriteError | import("@agentxm/workspace-transactions").WorkspaceSnapshotError, FileSystem.FileSystem | Path.Path>;
 export {};
 //# sourceMappingURL=settings.d.ts.map

package/dist/src/settings/settings.js

@@ -9,10 +9,8 @@ import * as FileSystem from "effect/FileSystem";
 import * as JsonPatch from "effect/JsonPatch";
 import * as Path from "effect/Path";
 import * as Schema from "effect/Schema";
-import { sweepStaleAtomicWriteTemps, writeFileAtomic } from "../utils/atomic-write.js";
 import { SettingsWriteError } from "./errors.js";
-import { protectWorkspacePath } from "../workspace/transaction.js";
-import { recordFootprint } from "../workspace/footprint-recorder.js";
+import { protectWorkspacePath, recordFootprint, sweepStaleAtomicWriteTemps, writeFileAtomic, } from "@agentxm/workspace-transactions";
 import { SETTINGS_KEY_ORDER, SETTINGS_KNOWN_KEYS, SettingsSchema, } from "./schema.js";
 import { applyJsonPatchToText } from "./format-preserving-json.js";
 // -----------------------------------------------------------------------------

package/dist/src/testing.d.ts

@@ -8,7 +8,31 @@
  * @experimental This API is unstable and may change without notice.
  * @packageDocumentation
  */
+import * as Layer from "effect/Layer";
+import { WorkspaceTransactionScope, type WorkspaceTransitionLock } from "@agentxm/workspace-transactions";
+import { ConfiguredAgentOutcomesProvider } from "./workspace/configured-agent-outcomes-provider.js";
+import { WorkspaceLocation } from "./workspace/location.js";
 export * from "./workspace/test-stubs.js";
+/**
+ * A transaction scope over the located workspace with the given admission —
+ * one invocation of a memory transition-lock world from
+ * `@agentxm/workspace-transactions/testing`, so no lock file is created and
+ * waits use Effect time. Compose beside `WorkspaceStateLive` from `./live`
+ * in place of the production scope.
+ */
+export declare const MemoryWorkspaceTransactionScope: (lock: WorkspaceTransitionLock) => Layer.Layer<WorkspaceTransactionScope, never, WorkspaceLocation>;
+/**
+ * A transaction scope over a mocked workspace's runtime directory. It places
+ * the two authoritative files where the project layout places them and takes
+ * its admission from an in-memory transition-lock world, so a test that runs
+ * a workspace transaction creates no lock file and waits on Effect time.
+ * Pass the same `axmDir` `makeBaseWorkspaceMock` was built with.
+ */
+export declare const MockWorkspaceTransactionScope: (axmDir?: string, options?: {
+    readonly lock?: WorkspaceTransitionLock;
+}) => Layer.Layer<WorkspaceTransactionScope>;
+/** A provider with no per-type refinement: every outcome stays generic. */
+export declare const ConfiguredAgentOutcomesProviderTest: Layer.Layer<ConfiguredAgentOutcomesProvider>;
 export { WorkspaceReadModelTest, type WorkspaceReadModelTestOptions, } from "./workspace/read-model/__fixtures__/test-layer.js";
 export * from "./workspace/read-model/__fixtures__/builder.js";
 export * from "./workspace/read-model/__fixtures__/decoders.js";

package/dist/src/testing.js

@@ -8,7 +8,42 @@
  * @experimental This API is unstable and may change without notice.
  * @packageDocumentation
  */
+import * as nodePath from "node:path";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { SETTINGS_FILENAME } from "@agentxm/extension-model/unstable/workspace-files";
+import { WorkspaceTransactionScope, makeWorkspaceTransactionScope, } from "@agentxm/workspace-transactions";
+import { WorkspaceTransactionScopeTest } from "@agentxm/workspace-transactions/testing";
+import { ConfiguredAgentOutcomesProvider } from "./workspace/configured-agent-outcomes-provider.js";
+import { LOCK_FILENAME } from "./workspace/constants.js";
+import { WorkspaceLocation } from "./workspace/location.js";
 export * from "./workspace/test-stubs.js";
+/**
+ * A transaction scope over the located workspace with the given admission —
+ * one invocation of a memory transition-lock world from
+ * `@agentxm/workspace-transactions/testing`, so no lock file is created and
+ * waits use Effect time. Compose beside `WorkspaceStateLive` from `./live`
+ * in place of the production scope.
+ */
+export const MemoryWorkspaceTransactionScope = (lock) => Layer.effect(WorkspaceTransactionScope, Effect.flatMap(WorkspaceLocation, (location) => makeWorkspaceTransactionScope({
+    workspaceDir: location.runtimeDir,
+    settingsPath: location.settingsPath,
+    lockPath: location.lockPath,
+}, lock)));
+/**
+ * A transaction scope over a mocked workspace's runtime directory. It places
+ * the two authoritative files where the project layout places them and takes
+ * its admission from an in-memory transition-lock world, so a test that runs
+ * a workspace transaction creates no lock file and waits on Effect time.
+ * Pass the same `axmDir` `makeBaseWorkspaceMock` was built with.
+ */
+export const MockWorkspaceTransactionScope = (axmDir = "/tmp/axm", options) => WorkspaceTransactionScopeTest({
+    workspaceDir: axmDir,
+    settingsPath: nodePath.join(axmDir, SETTINGS_FILENAME),
+    lockPath: nodePath.join(axmDir, LOCK_FILENAME),
+}, options);
+/** A provider with no per-type refinement: every outcome stays generic. */
+export const ConfiguredAgentOutcomesProviderTest = Layer.succeed(ConfiguredAgentOutcomesProvider, { byExtensionType: {} });
 export { WorkspaceReadModelTest, } from "./workspace/read-model/__fixtures__/test-layer.js";
 export * from "./workspace/read-model/__fixtures__/builder.js";
 export * from "./workspace/read-model/__fixtures__/decoders.js";

package/dist/src/utils/path-safety.d.ts

@@ -2,11 +2,6 @@ import * as Effect from "effect/Effect";
 import * as Option from "effect/Option";
 import * as Path from "effect/Path";
 import { type AbsolutePath } from "@agentxm/extension-model/unstable/path-types";
-/**
- * Validates that a resolved target path stays within a base directory.
- * Uses path separator boundary check to prevent prefix false positives.
- */
-export declare const isPathSafe: (path: Path.Path, base: string, target: string) => boolean;
 /**
  * Resolve `target` and return it only when it stays inside `base`.
  */

package/dist/src/utils/path-safety.js

@@ -2,16 +2,7 @@ import * as Data from "effect/Data";
 import * as Effect from "effect/Effect";
 import * as Option from "effect/Option";
 import * as Path from "effect/Path";
-import { makeAbsolutePath } from "@agentxm/extension-model/unstable/path-types";
-/**
- * Validates that a resolved target path stays within a base directory.
- * Uses path separator boundary check to prevent prefix false positives.
- */
-export const isPathSafe = (path, base, target) => {
-    const resolvedBase = path.resolve(base);
-    const resolvedTarget = path.resolve(target);
-    return resolvedTarget === resolvedBase || resolvedTarget.startsWith(resolvedBase + path.sep);
-};
+import { isPathSafe, makeAbsolutePath, } from "@agentxm/extension-model/unstable/path-types";
 /**
  * Resolve `target` and return it only when it stays inside `base`.
  */

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

@@ -5,7 +5,7 @@ import * as Path from "effect/Path";
 import type { ExtensionRef } from "@agentxm/extension-model/unstable/extensions/refs/extension-ref";
 import { AcceptedResolutionMissing, InlineExtensionSourceMissing, SupersededCanonicalRemovalFailed, type PackageContentHashFailed, type WorkspaceSourceInvalid } from "./errors.js";
 import type { PathTraversalDetected } from "../utils/path-safety.js";
-import type { WorkspaceSnapshotError } from "./transaction.js";
+import type { WorkspaceSnapshotError } from "@agentxm/workspace-transactions";
 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";

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

@@ -9,7 +9,7 @@ import { hookLockEntryToRef, knowledgeLockEntryToRef, mcpServerLockEntryToRef, p
 import { observeCanonicalExtension, } from "./canonical-observation.js";
 import { computeExtensionPathsForLayout, extensionPathSourceFromLockEntry, } from "./extension-paths.js";
 import { toExtensionTypePlural } from "@agentxm/extension-model/unstable/extensions/common";
-import { protectWorkspacePath } from "./transaction.js";
+import { protectWorkspacePath } from "@agentxm/workspace-transactions";
 import { resolveWorkspaceExtensionRef } from "./configured-entry-resolution/workspace-ref.js";
 /** Canonical package AXM may delete when removing desired state. Authored source is durable. */
 export const removableAcceptedCanonicalPath = (canonical) => Option.flatMap(canonical, (state) => state.desired.identity.startsWith("workspace:")

package/dist/src/workspace/accepted-resolution-writer.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Accepted-resolution writer: lockfile-only mutations of the selected scope.
+ * Each commit merges the lockfile snapshot per entry, keeps an accepted
+ * resolution that is semantically unchanged byte-identical, and is
+ * serialized by the workspace's mutation mutex.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as ServiceMap from "effect/Context";
+import * as Effect from "effect/Effect";
+import type * as FileSystem from "effect/FileSystem";
+import * as Layer from "effect/Layer";
+import type * as Path from "effect/Path";
+import type * as Semaphore from "effect/Semaphore";
+import type { InstallableExtensionType } from "@agentxm/extension-model/unstable/extensions/installable-types";
+import { type LockEntryByType } from "./entry-accessors.js";
+import { WorkspaceLocation, type WorkspaceLocationService } from "./location.js";
+import type { WorkspaceLockfileMutationFailure } from "./service-interface.js";
+import { WorkspaceStateShared } from "./shared.js";
+type Write = Effect.Effect<void, WorkspaceLockfileMutationFailure, FileSystem.FileSystem | Path.Path>;
+export interface AcceptedResolutionWriterService {
+    /**
+     * Record one accepted resolution under its lock key (the workspace name,
+     * or the MCP resolution key). A skill or subagent resolution that is
+     * semantically unchanged is not rewritten.
+     */
+    readonly setAccepted: <T extends InstallableExtensionType>(type: T, key: string, entry: LockEntryByType[T]) => Write;
+    /** Remove one accepted resolution. No-op when absent. */
+    readonly removeAccepted: (type: InstallableExtensionType, key: string) => Write;
+}
+declare const AcceptedResolutionWriter_base: ServiceMap.ServiceClass<AcceptedResolutionWriter, "@agentxm/workspace-state/AcceptedResolutionWriter", AcceptedResolutionWriterService>;
+export declare class AcceptedResolutionWriter extends AcceptedResolutionWriter_base {
+}
+/** Structural equality that treats date-times by their ISO rendering. */
+export declare const stableCompare: (left: unknown, right: unknown) => boolean;
+export declare const lockEntrySemanticallyEqual: <TEntry>(current: TEntry | undefined, next: TEntry) => boolean;
+/** Keep the recorded object when the replacement carries the same facts. */
+export declare const preserveAcceptedResolutionOnNoop: <TEntry>(current: TEntry | undefined, next: TEntry) => TEntry;
+export declare const makeAcceptedResolutionWriter: (location: WorkspaceLocationService, mutex: Semaphore.Semaphore) => AcceptedResolutionWriterService;
+export declare const AcceptedResolutionWriterLive: Layer.Layer<AcceptedResolutionWriter, never, WorkspaceLocation | WorkspaceStateShared>;
+export {};
+//# sourceMappingURL=accepted-resolution-writer.d.ts.map