feat(tools): add description and parametersSchema to Tool interface; wire FileWriteTool materialization

infrastructure/tools/src/main/kotlin/com/correx/infrastructure/tools/ToolConfig.kt

@@ -1,5 +1,7 @@
 package com.correx.infrastructure.tools
 
+import com.correx.core.artifactstore.ArtifactStore
+import com.correx.core.artifacts.MaterializingArtifactWriter
 import com.correx.core.tools.contract.Tool
 import com.correx.infrastructure.tools.filesystem.FileEditTool
 import com.correx.infrastructure.tools.filesystem.FileReadTool
@@ -15,7 +17,13 @@ data class ToolConfig(
 )
 
 data class FileReadConfig(val enabled: Boolean = false, val allowedPaths: Set<Path> = emptySet())
-data class FileWriteConfig(val enabled: Boolean = false, val allowedPaths: Set<Path> = emptySet())
+data class FileWriteConfig(
+    val enabled: Boolean = false,
+    val allowedPaths: Set<Path> = emptySet(),
+    val artifactStore: ArtifactStore? = null,
+    val materializingWriter: MaterializingArtifactWriter? = null,
+    val sandboxRoot: Path? = null,
+)
 data class FileEditConfig(val enabled: Boolean = false, val allowedPaths: Set<Path> = emptySet())
 data class ShellConfig(val enabled: Boolean = false, val allowedExecutables: Set<String> = emptySet())
 
@@ -35,7 +43,10 @@ fun ToolConfig.buildTools(): List<Tool> = buildList {
     }
     if (fileWrite.enabled) {
         add(FileWriteTool(
-            allowedPaths = fileWrite.allowedPaths
+            allowedPaths = fileWrite.allowedPaths,
+            artifactStore = fileWrite.artifactStore,
+            materializingWriter = fileWrite.materializingWriter,
+            sandboxRoot = fileWrite.sandboxRoot,
         ))
     }
     if (fileEdit.enabled) {

infrastructure/tools/src/main/kotlin/com/correx/infrastructure/tools/shell/ShellTool.kt

@@ -12,12 +12,16 @@ import kotlinx.coroutines.TimeoutCancellationException
 import kotlinx.coroutines.async
 import kotlinx.coroutines.withContext
 import kotlinx.coroutines.withTimeout
+import kotlinx.serialization.json.JsonObject
+import kotlinx.serialization.json.buildJsonObject
 
 class ShellTool(
     private val allowedExecutables: Set<String> = emptySet(),
     private val timeoutMs: Long = 30_000L,
 ) : Tool, ToolExecutor {
     override val name: String = "shell"
+    override val description: String = "Execute a shell command"
+    override val parametersSchema: JsonObject = buildJsonObject {}
     override val tier: Tier = Tier.T2
     override val requiredCapabilities: Set<ToolCapability> =
         setOf(ToolCapability.SHELL_EXEC, ToolCapability.PROCESS_SPAWN)