@maanster/dreamaan-mcp 0.5.2 → 0.6.1

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.6.1] - 2026-10-09
+
+- `asset_get(includePreview: true)` returns bounded native image content from the authorized selected file, independent of MCP Apps; ordinary metadata calls do not fetch bytes.
+- Improve connection discovery, category-first asset search and upload-picker guidance; clarify integer KB in legacy attach calls.
+- BytePlus status hints poll pending work and stop recommending registration starts for active files.
+- Production skill 0.4.1 includes native preview and real-client discovery guidance. Fix Docker builds to include skill-export inputs.
+
+## [0.6.0] - 2026-10-09
+
+- Add an MCP Apps asset upload picker, browser handoff and completion recovery without requiring the CLI.
+- Add accessible media URL imports backed by SSRF-protected managed upload sessions.
+- Add native Windows credential and upload-state protection with NTFS ACLs and platform CI.
+- Ship production skill 0.4.0 with cross-client upload guidance and checksum-based update discovery.
+
 ## [0.5.2] - 2026-10-09
 
 - Publish maintained skill files and ZIP through HTTP with version, compatibility, SHA-256 checksums and conditional downloads.

package/README.md

@@ -12,17 +12,23 @@ Connect your AI assistant to Dreamaan to work with projects, assets, generation
 
 Hosted and local connections have separate sign-in sessions. Installing the package does not grant access to Dreamaan projects.
 
+## Uploads in different clients
+
+Hosted users can upload without this package: the MCP upload tool opens an in-chat file picker in compatible clients, with a browser link for other clients. Accessible media URLs can be imported directly. Existing Dreamaan assets can be reused without another upload. A remote MCP connection does not expose private chat attachments or local computer paths; choose the original file in the picker instead.
+
+For local terminal workflows, `dreamaan upload` transfers the selected original and registers its asset/version. Read [upload workflows](docs/client/uploads.md) for recovery and file-size limits, and [client compatibility](docs/client/upload-clients.md) for what is verified.
+
 ## Requirements
 
 - Node.js 22 or later.
-- Linux or macOS for local credential and upload-state storage. Windows is currently unsupported.
+- Linux/macOS with POSIX private files, or Windows with a local NTFS filesystem and Windows PowerShell for user-restricted credential and upload-state storage. Hosted MCP requires neither Node.js nor the CLI.
 - A Dreamaan account and access to the projects you intend to use.
 - Your environment's API URL, including `/api`. Use the URL provided by your Dreamaan administrator; do not substitute a web-app or MCP URL.
 
 ## Install
 
 ```sh
-npm install --global @maanster/dreamaan-mcp@0.5.1
+npm install --global @maanster/dreamaan-mcp@0.6.0
 dreamaan-mcp --version
 dreamaan --help
 ```
@@ -109,12 +115,16 @@ OAuth logout revokes the CLI connection and removes its local profile. Uninstall
 
 ## Production skill and workflows
 
-The package includes the Dreamaan production skill (version 0.3.1): screenplay breakdown into sequences/plans/outputs, character/location/prop preparation and linking, version-pinned frames to videos, assignments/reviews and production budgeting.
+The package includes the Dreamaan production skill (version 0.4.1): screenplay breakdown into sequences/plans/outputs, character/location/prop preparation and linking, version-pinned frames to videos, assignments/reviews and production budgeting.
 
 Run `npm root --global`, then copy the complete `@maanster/dreamaan-mcp/skills/dreamaan` folder to your client's skills directory. Keep its reference guides with it and connect Dreamaan MCP. A skill-capable client can then use it for requests such as “Break this screenplay into plans and propose an asset checklist and budget” or “Create a reviewed frame-to-video pilot for this plan.”
 
 Dreamaan web settings also provide a downloadable skill bundle and client instructions. Clients without skill installation can call `workflow_get`, read `dreamaan://workflows/overview`, or use the `production_workflow` prompt if supported. These guides never perform writes or spending themselves.
 
+Settings → Connect with MCP also offers a copyable setup prompt for your selected assistant. It reuses existing connections, guides OAuth sign-in, installs the complete skill where supported, and adds the optional CLI only when local capabilities require it. You complete browser sign-in and access consent; agents without settings or file access provide the remaining steps.
+
+To show an asset image directly in a compatible chat, call `asset_get` with `includePreview: true`. The result contains native MCP image content (up to 1 MiB), separate from JSON metadata, using the chosen file version. No browser screenshot is required. Host rendering support varies; metadata calls still return URLs, and the original file remains unchanged.
+
 ## Additional guides
 
 The installed package includes `docs/client/` guides for login, uploads, paging and the optional `skills/dreamaan/` workflow skill. These files are bundled with the package; no source-repository access is required. To locate a global installation, run `npm root --global`, then open its `@maanster/dreamaan-mcp` folder.