summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authortanaka takashi <isazaka@gmail.com>2026-08-14 18:00:29 +0900
committertanaka takashi <isazaka@gmail.com>2026-08-14 18:00:29 +0900
commita8233adff75a4726015c7c96ce5e864d4506f6b2 (patch)
tree8ce06e1bc5d605b9681259260c99a47921e65413 /README.md
parente07183ee6d3e57da325213e898cdcd6687320f53 (diff)
release: prepare WinAgent Sandbox MCP v0.1.0HEADmain
Unify the public product name and repository identifier while preserving stable executable, store, AppContainer, namespace, pipe, and mutex identifiers. Make Directory.Build.props VersionPrefix the application-version source of truth, use SDK-generated assembly metadata, and compare helper compatibility by parsed major/minor/build release identity. Rebuild the fixed winagent-sandbox-mcp release staging directory from clean defaults, emit versioned ZIP/checksum assets, verify manifests and fresh extraction, and reject local configuration, user state, and test artifacts. Document release/deployment separation and upgrade responsibilities, add the initial changelog, update operational script paths, and record the v0.1.0 verification results.
Diffstat (limited to 'README.md')
-rw-r--r--README.md34
1 files changed, 28 insertions, 6 deletions
diff --git a/README.md b/README.md
index f0261db..bd01fff 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
-# AI Agent Sandbox MCP Server
+# WinAgent Sandbox MCP
-Windows上でOllamaを利用し、AIエージェントのファイル操作とプロセス実行を、利用者がYAMLで指定した範囲へ閉じ込めるMCP Serverです。MCP Clientには`agent_run`と`agent_status`だけを公開します。
+Windows 11 x64上でOllamaを利用し、AIエージェントのファイル操作とプロセス実行を利用者がYAMLで指定した範囲へ閉じ込めるMCP Serverです。LPAC、NTFS ACL、Job Object、WFPでSandbox Process Treeを強制し、通常権限のmain processからTask単位で必要なnetwork操作だけをUAC昇格します。MCP Clientには`agent_run`と`agent_status`だけを公開します。
## 機能
@@ -69,7 +69,7 @@ sandbox:
profile: normal
```
-実環境用path、Prompt、Skillは`agent.local.yaml`から指定できます。publish/upgradeは`agent.local.yaml`、`local/`、`logs/`、`state/`、適用済み設定Storeを上書きしません。
+実環境用path、Prompt、Skillは`agent.local.yaml`から指定できます。Release artifact生成用stagingにはこれらの利用者状態を含めません。利用者deploymentをupgradeするときはExecutableと既定資産だけを置換し、`agent.local.yaml`、`local/`、`logs/`、`state/`、適用済み設定Storeを上書きしないでください。
### 権限マトリックス
@@ -164,9 +164,9 @@ stdioでもMCP Clientは通常権限で起動します。ファイル操作だã�
```json
{
"mcpServers": {
- "agent-sandbox": {
- "command": "C:\\tools\\agent-sandbox-mcp\\agent-mcp.exe",
- "args": ["C:\\tools\\agent-sandbox-mcp\\agent.yaml"]
+ "winagent-sandbox-mcp": {
+ "command": "C:\\tools\\winagent-sandbox-mcp\\agent-mcp.exe",
+ "args": ["C:\\tools\\winagent-sandbox-mcp\\agent.yaml"]
}
}
}
@@ -221,6 +221,28 @@ dotnet test AgentSandboxMcp.slnx -c Release --no-build --no-restore
.\scripts\Publish-Release.ps1
```
+## Releaseとupgrade
+
+`Publish-Release.ps1`は`Directory.Build.props`のApplication Versionを読み取り、次を生成します。展開済みBundle directoryは利用者deploymentではなく、実行のたびに完全再生成されるRelease staging成果物です。
+
+```text
+build/Release/publish/
+ winagent-sandbox-mcp/
+ winagent-sandbox-mcp-v<version>-win-x64.zip
+ winagent-sandbox-mcp-v<version>-win-x64.zip.sha256
+```
+
+ZIP内のroot directory名とExecutable名にはversionを含めません。`agent.local.yaml`、`local/`、`logs/`、`state/`、Applied Configuration StoreはBundleとZIPに含まれません。
+
+利用者deploymentのupgradeでは、ZIP内のExecutableと既定資産だけを置換し、利用者固有のlocal設定、Prompt、Skill、logs、state、Applied Configuration Storeを保持してください。旧version付きdirectoryから新しいdeployment pathへ移す場合は、local資産を利用者が移動し、新しいconfig pathに対して次を実行します。
+
+```powershell
+.\agent-mcp.exe show .\agent.yaml
+.\agent-mcp.exe apply .\agent.yaml
+```
+
+本Repositoryはinstallerやdeployment upgrade scriptを提供しません。
+
詳細は[仕様書](doc/Specifications.md)と[設計書](doc/Design.md)を参照してください。
## ライセンス