* feat(operations): add create_project operation across agent, mcp, and cli
* fix(api): remove legacy team creation endpoint
* fix(api): preserve ProjectInfo response on POST /teams/:teamId/projects
* refactor(agent)!: migrate sessions to Pi Durable
Replace patched AgentHarness storage with per-session SQLite and PostgreSQL commit mirroring. Migrate legacy history automatically and run agent queues with the main server.
BREAKING CHANGE: Remove standalone agent workers and return native Pi entry records from chat history APIs.
* fix(agent): constrain session log dialog scrolling
Keep the header visible and wrap long output while log entries and expanded records scroll within the dialog. Cover desktop and narrow viewports through the dashboard Sessions flow.
* fix(agent): hide entry IDs from session log card headers
Retain internal entry IDs in expanded raw records for debugging. Verify that card headers omit the IDs while raw JSON preserves them.
* test(e2e): handle browser wheel limits in session log checks
Verify that a normal wheel event moves the viewport before explicitly scrolling to the final record. Keep the dialog bounds, fixed header, wrapping, and expanded-record assertions.
* fix(agent): select model providers without inheriting unrelated auth
* fix(webui): prevent resize feedback when toggling agent panel
* test(agent): reproduce concurrent comment session races
* fix(agent): serialize comment sessions and deduplicate history
* docs(changelog): consolidate Pi Durable changes into one entry
* fix: gracefully handle remote HTTP URLs for MCP and cache production static assets
* test(mcp): add remote http mcp integration test and fix static etag normalization and fallback error
* fix(security): improve access control and storage security
* fix(security): set NODE_ENV in dockerfiles and sign local storage get urls with lru cache
* feat(storage): add team auto-archive assets policy and background job
* fix(storage): address code review feedback on lock safety, starvation, and permissions
* docs: update readme and expand archive storage documentation with auto-archive details
* feat(storage): log info message on auto-archive job start and finish with archived count
* style(storage): stack age threshold and grace period vertically with updated grace period description
* fix(storage): only log auto-archive info messages when candidate assets are found to process
* feat(storage): add archive storage support for assets
* fix(webui): show archive icon in front of file name in breadcrumb bar
* fix(webui): display archive icon in breadcrumbs when restoring
* refactor(transcode): simplify restore asset workflow to single while loop
* docs(configuration): add archive storage documentation and readme entries
* fix(webui): show archive icon in front of version names and prevent version card overflow
* fix(webui): fix overflow in manage versions dialog scroll area
* fix(webui): prevent manage versions dialog overflow on long file names
* docs(configuration): fix archive storage environment variables and defaults
* fix(storage): address code review findings for archive storage
* feat(file): optimize upload and transcoding status polling with batch api
* fix(webui): throttle search invalidation during upload and fix stuck 100% progress ring
* fix(webui): deduplicate upload search invalidation and stabilize batch polling
* fix(core): strip trailing slashes when normalizing auth and MCP resource URLs
* docs: document BETTER_AUTH_URL in README and quickstart guides
* docs: prioritize AWS_ENDPOINT_URL_S3 and clarify applicability to local storage
* docs: refine AWS_ENDPOINT_URL_S3 guidance for local storage deployments
* feat(mcp): add OAuth 2.1 support with dynamic client registration
* feat(api): alias bare oauth-authorization-server discovery endpoint
* fix(auth): preserve user session on OAuth sign-in redirect to consent
* feat(operations): move MCP to /mcp and add search, comment, metadata, version, and upload operations
- Serve the MCP server at /mcp instead of /api/mcp
- Add search_assets, copy_assets, get_folder_instructions, list_comments,
create_comment, resolve_comment, list_metadata_fields,
update_asset_metadata, create_version_stack, list_versions, and
remove_version on the agent, MCP, and CLI
- Add create_file and create_version (agent, MCP) with Creation Context
metadata, and complete_upload (MCP) for presigned two-step uploads
- Replace the native agent create_file/create_version tools with
Operation-backed ones
- Route the comment-complete, metadata, copy, version stack, and
AGENTS.md read REST endpoints through their Operations
* docs(readme): add built-in MCP server and CLI to features list
* feat(asset-read): expose read_asset on MCP and the CLI
Enable the mcp and cli surfaces for read_asset and get_asset_render.
- MCP: add per-Operation tool extensions. The read presenter attaches up
to 8 images (2 MB each) inline, lists image links, supports
inlineImages: false, and tells the model to call get_asset_render when
a render is pending. Storage keys are stripped from the result.
- CLI: generated commands can flatten object inputs into prefixed flags
(cli.flatten) and omit fields (cli.omit); add per-command extensions.
New `read` and `render` commands print image links, download them with
--out, and support --no-wait with a printed `render <taskId>` hint.
- Round frame timestamps in labels to 3 decimals.
* fix(mcp): make tool input schemas portable to single-type dialects
Nullable inputs were emitted as `type: ["number", "null"]` (or a `null`
anyOf branch), which clients that map tool schemas onto an OpenAPI-style
subset (e.g. Gemini function declarations) may reject.
- Make read_asset's startPage, endPage, and degree optional instead of
nullable.
- Move null handling into a shared dropNullOptionals helper in
@shumai/operations that also strips nulls inside nested config
objects. The agent uses it, and the MCP server applies it before the
SDK validates arguments, so models that send null keep working.
- Test that no Operation input schema (and no listed MCP tool) uses a
nullable type.
* feat(asset-download): share download_asset across agent, MCP and CLI
Turn the agent-only download_asset tool into an Operation on all three
surfaces.
- download_asset takes up to 50 file or version stack IDs and returns
presigned links. proxy (default true) picks the web preview when there
is one, as the agent always did; proxy: false returns the original.
Folders are rejected. Read is checked on every ID before anything runs.
- Agent: an extension saves the files into the .pi sandbox and keeps the
agent-only storage key mode (e.g. frames from read_asset). Agent tool
extensions gain description, parameterOverrides and intercept.
- CLI: `shumai-cli download <assetId...> [--out <dir>] [--original]`
streams files to disk without overwriting existing names.
- read_asset's unsupported-type error now names the right way to
download on each surface (download_asset, or `shumai-cli download`).
- Add the Download Asset toggle to agent settings.
Add a stateless Streamable HTTP MCP server at /api/mcp that exposes every
mcp-surface Operation with its input/output schemas and annotations, and
POST /api/ops/:name for the CLI. Both require an API token (session
cookies are rejected), run Operations as the token's user, honor demo
read-only mode, and record via mcp/cli/api in audit logs.
Also make list_projects toggleable in agent settings and document MCP
client setup.
Introduce @shumai/operations (pure definitions: Zod schemas, metadata,
CLI hints) and @shumai/core/src/operations (implementOperation and the
runOperation pipeline: validate, authorize, prepare, execute, validate
output, audit).
Migrate list_assets, create_folder, rename_asset, move_assets and
delete_asset to Operations, and add list_projects. The agent now builds
these tools from the registry, and the folder create/rename, file
rename and reparent routes call the same Operations.
Audit logs gain a nullable via column recording the surface. A lint
rule keeps the Prisma client out of Operation implementations.
New tokens are 32 random bytes with a shumai_ prefix and are returned
only once at creation. The list endpoint returns a 4-character hint
instead of the plaintext. A migration hashes existing tokens in place so
they keep authenticating.
* feat(dashboard): add workflow tasks monitoring and stopping to team dashboard
* fix(asset): retain workflow tasks on asset purge and mark active tasks as failed
* style(webui): add edge padding to audit logs and workflow tasks tables
* fix(workflow): atomically update asset status to failed when task is stopped
* fix(workflow): propagate cancellation errors, guard concurrent task stop, and localize UI
* docs(changelog): keep only added log for workflow tasks dashboard
* test(provider): mock upstream catalog api calls using saved fixtures
* feat(dashboard): show file name, size, and project name in workflow tasks list
* feat(embedding): update compose tiers, docs, and add regenerate-embeddings CLI
- Add Lite, Embedding, and Full Docker Compose configurations (and Aliyun mirrors)
- Set CONCURRENCY_AGENT to 1 for compose files containing embedding-server
- Update README and README_CN with compose options, recommended RAM, and semantic search links
- Add LiteRT-LM Embedding Server setup guide in docs/using-shumai/embedding-server.mdx
- Add shumai regenerate-embeddings CLI command and EmbeddingService to regenerate embeddings across teams
- Add comprehensive test coverage for EmbeddingService
* fix(docker): remove basic auth for turntable-renderer in full compose
* fix(agent): lock and disable embedding agent when ENABLE_EMBEDDING_AGENT is false
Ensure that when ENABLE_EMBEDDING_AGENT is set to 'false', existing embedding agents are automatically disabled on startup, marked as read-only, and blocked from manual API modifications or creations. Additionally guard background task creation and semantic search when the environment variable disables embedding agents.
* test(upload): remove flaky status assertion on workflow tasks
* feat(agent): support gemma-embedding-2-openai provider
Add support for local LiteRT-LM Gemma Embedding 2 provider with 768-dimensional vector embeddings, environment-configured read-only embedding agents, 16-frame uniform sampling for video chunks, and automatic WebP-to-JPEG conversion.
* refactor(agent): remove unused legacy generateEmbeddingActivity
* chore(agent): align sharp version to 0.35.4
* refactor(agent): rename embedding server env to GEMMA_EMBEDDING_OPENAI_BASE_URL
* refactor(agent,transcode): use native Bun.Archive for video chunk frames
* fix(transcode,agent): populate buffer entries in Bun.Archive and validate frame sizes
* feat(team): add integrations settings with turntable and gotenberg
* fix(upload): pass teamId to gotenberg availability check during upload preflight
* feat(transcode): add 3D asset support and turntable viewer
* perf(turntable): stream file via Bun.file and increase upload timeout
* feat(turntable): increase upload timeout to 15m to support 5GB uploads
* fix(webui): align 3D model viewer layout and full-width control bar with video viewer
* feat(webui): unify 3D viewer bottom bar and redesign cyclic ruler slider
- Place RulerSlider in single row with playback and zoom controls, centered with max 320px width
- Flank RulerSlider with minus and plus buttons to step angle by 15°
- Redesign RulerSlider with fixed center indicator and moving cyclic track with continuous 360° wrapping
- Render major ticks longer at 60° intervals without numeric text labels on track
- Display floating degree tooltip above center indicator only during dragging
* fix(webui): prevent RulerSlider from collapsing to 0px width in control bar
- Use flex layout with flex-1 on left and right clusters to preserve center cluster width
- Enforce min-w-[140px] and w-full on RulerSlider
- Fix tooltip positioning and remove outer overflow-hidden
* feat(webui): snap RulerSlider track directly to discrete 15° ticks during drag
* fix(webui): prevent ruler snap-back caused by floating point second truncation
- Use Math.round instead of Math.floor in secondToDegree to avoid 0.999996 dropping to previous frame
- Ensure final dragDegree is committed on pointer up
* fix(webui): fix arrow key frame rounding and duplicate event bubbling
- Use Math.round instead of Math.floor for keyboard arrow frame navigation in ModelViewer
- Add e.stopPropagation() to RulerSlider keyboard events to prevent duplicate bubbling to window listener
* feat(webui): redesign RulerSlider with encapsulated step buttons and capsule pill track
* feat(webui): make RulerSlider responsive on mobile and remove bottom bar reset button
* fix(webui): load 3d video directly without poster and invert drag rotation to counterclockwise
* fix(webui): fix 3d asset viewer frame seeking and drag jitter
* feat(transcode): show 3D asset poster preview immediately after render start
* fix(viewer): synchronize 3D turntable playback via frame callback to prevent skipped degrees
* fix(viewer): handle touchpad zoom gestures and prevent page zoom in 3D viewer
* fix(viewer): eliminate 3D model rotation jitter at 345 degrees
* fix(share): watermark 3D asset turntable video on share links
* fix(share): preserve video transcode resolution on watermarked share links
* fix(viewer): download original 3D model file instead of rendered turntable MP4
* feat(transcode): add multi-resolution strategy with configurable ladders and fallback
* feat(settings): show toast on settings update and add manual verification plan to PR template
* fix(webui): preserve video resolution and fix 480p label in download dropdowns
* fix(webui): display standard short-side resolution for vertical videos in seekbar
* fix(webui): fix portrait transcode resolution labeling and serialize settings toggles
* feat(transcode): add HDR output proxy support
* fix(transcode): auto-detect MoltenVK Vulkan ICD on macOS for libplacebo filters
* fix(transcode): split filter in generateSprite to ensure poster uses tone-mapped stream
* docs(changelog): update docs/changelog.mdx and ignore in prettier
* fix(transcode): respect video rotation metadata to preserve display aspect ratio
* fix(webui): render native video with hardware EDR acceleration instead of 2D canvas
* fix(webui): show HDR label on mobile video control bar
* fix(share): preserve hdr flag on watermarked video transcodes
* fix(webui): differentiate HDR download options in video player
* fix(transcode): handle Dolby Vision Profile 5 via standard HDR pipeline without libplacebo
* fix(transcode): prepend setparams filter to prevent zscale colorspace path error for DV P5
* refactor(transcode): simplify HDR proxies to always produce HDR without SDR setting
* feat(settings): add team appearance setting to hide agent features
Add an Appearance subpage under Team Settings allowing team owners to toggle appearance.hideAgent for the team. Return appearance.hideAgent in the user-metadata API, and conditionally hide the AGENTS.md button, agent chatbot sidebar, and chatbot trigger button in the WebUI.
* refactor(settings): add strongly typed TeamSettingsResponse to remove explicit any
Introduce TeamSettingsResponse and TeamAppearanceSettings in @shumai/dtos, type TeamService.getSettings and updateSettings, and eliminate the explicit any cast in AppearanceSettings.tsx.
* feat(premiere-uxp): use native Bun bundler and build script instead of Vite
* feat(premiere-uxp): switch FileListView to use Search API consistent with WebUI
* feat(premiere-uxp): add on-demand jpeg preview conversion for uxp compatibility
* feat(premiere-uxp): integrate spectrum web components (swc)
* fix(premiere-uxp): align swc packages with 0.37.0 and fix auth layout
* feat(premiere-uxp): use horizontal 2-column card view for projects and files
* style(premiere-uxp): enlarge file preview by 20% and add row padding
* fix(premiere-uxp): prevent card squishing and overflow with large item counts
* fix(premiere-uxp): change host in manifest to single object
* docs(premiere-uxp): add AGENTS.md with SWC preferences and UXP layout rules
* feat(premiere-uxp): integrate spectrum web components across plugin views
* fix(premiere-uxp): remove breadcrumb icons and use slash separator
* feat(premiere-uxp): add collapsible folder and file sections with infinite scroll
* feat(premiere-uxp): update file card layout with right column info and clean preview
* fix(premiere-uxp): use raw text for file card details and fix black icons
* style(premiere-uxp): use contain object-fit and black background for file card preview
* fix(premiere-uxp): refine header logo, sticky title bars, circular badges, and controls
* fix(premiere-uxp): replace stroke icons with spectrum workflow icons
* fix(premiere-uxp): switch icon buttons to swc sp-button with icon-only and slot=icon
* fix(premiere-uxp): vertically center endpoint text in header
* feat(premiere-uxp): add asset and proxy import support into Premiere Pro
- Implement context menu on file cards with left-click, right-click, and more action button triggers
- Support raw file import for non-video assets and video assets
- Support video proxy submenu listing ready transcode resolutions
- Add UXP native file picker save dialog and binary download orchestration
- Call Premiere Pro project.importFiles API to import downloaded assets into active project
- Add non-blocking toast notification banner for progress and status reporting
- Add unit tests for premiere host service and import orchestration
* fix(premiere-uxp): anchor import menu directly to file card using sp-action-menu
- Replace custom fixed-position ContextMenu with native SWC sp-action-menu
- Anchor menu directly to the triggered file card rather than the top-left window corner
- Support programmatic opening on file card click/contextmenu via imperative handle
- Support video submenu with Original and ready proxy options inside sp-action-menu
- Lazy load video proxies on menu open or hover
- Clean up obsolete fixed-position styles and unused backdrop overlays
* fix(premiere-uxp): align SWC packages to 0.37.0 and guard custom element registry
- Downgrade action-menu and menu SWC packages to 0.37.0 to match the rest of the workspace
- Eliminate duplicate icons-ui and sp-icon-chevron100 customElements.define calls
- Add polyfill guard to customElements.define to prevent duplicate registration errors during UXP reload
* fix(premiere-uxp): polyfill window.matchMedia for Adobe UXP
- Add window.matchMedia polyfill in polyfills.ts
- Satisfies SWC MatchMediaController used by ActionMenu and PickerBase in UXP
- Prevents TypeError when opening files page
* feat(premiere-uxp): replace context menu with card download action and video import dialog
* fix(premiere-uxp): resolve download url before save, pass null targetBin, and center download icon
* fix(premiere-uxp): resolve raw download url via download-url endpoint with fallback
* feat(premiere-uxp): use native folder picker and auto-increment conflict suffixes
* feat(premiere-uxp): add sequence linking, comment-marker sync, and navigation tabs
- Add sequence-to-asset linking with persistent project metadata storage
- Support one-way comment-to-marker timeline synchronization
- Add two-tab navigation (Sequences and Browse) using Spectrum buttons
- Add LinkSequenceDialog, SequencesView, and autoSyncService background engine
- Enforce Spectrum Workflow Icons and UXP layout rules
* feat(premiere-uxp): refine UI layouts, card interactions, and search box activation
* fix(premiere-uxp): set compact fixed width for file list search box
* fix(premiere-uxp): ensure search box click activation across full width in UXP
* fix(premiere-uxp): revert search box hacks and restore simple default sp-search layout
* feat(premiere-uxp): sync non-timestamped comments as markers at time 0
* feat(premiere-uxp): change link icon to unlink when asset is linked in file card
* fix(premiere-uxp): sync linked sequences between host project and browse view
* feat(premiere-uxp): remove synced markers on sequence unlink matching Frame.io
* fix(premiere-uxp): ensure reliable marker GUID capture, normalization, and fallback on unlink
* fix(premiere-uxp): use official Shumai logo for plugin manifest icons
* fix(premiere-uxp): use official PNG icons for manifest and plugin entrypoints
* refactor(premiere-uxp): use single 114x114 icon for plugin and panel
* feat(premiere-uxp): show file version in file list page file card
* build(premiere-uxp): check in built ccx package and update packaging configuration
* fix(premiere-uxp): address code review findings for media conversion, marker sync, and link scoping
- Reset hasJpegCover on project cover update and hasJpegPreview on asset media transcode
- Only advance synced comment metadata after confirmed marker transaction
- Normalize GUID keys and lookups in AutoSyncService map
- Restrict cached sequence link lookups to project-specific keys and prevent cross-project leakage on empty sequences
- Update built CCX distribution package
* feat(comment): add emoji reaction support for comments
* fix(webui): adjust emoji picker trigger icon size to match mark-done icon
* fix(webui): prevent search icon and placeholder overlap in emoji picker
* fix(webui): use normal text color for reaction count
* feat(db): limit comment reaction code column to VarChar(32)