mirror of
https://github.com/shumaiOne/shumai.git
synced 2026-11-22 23:17:37 +00:00
* 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.
33 lines
1.1 KiB
TypeScript
33 lines
1.1 KiB
TypeScript
import { createWriteStream } from 'node:fs'
|
|
import { rm } from 'node:fs/promises'
|
|
import { Readable } from 'node:stream'
|
|
import { pipeline } from 'node:stream/promises'
|
|
import type { ReadableStream as WebReadableStream } from 'node:stream/web'
|
|
import { CliError } from '../errors'
|
|
|
|
/** Streams a download link to `filePath` (large files never sit in memory). */
|
|
export async function saveUrlToFile(url: string, filePath: string, label: string): Promise<void> {
|
|
let res: Response
|
|
try {
|
|
res = await fetch(url)
|
|
} catch (err) {
|
|
throw new CliError(
|
|
`Failed to download "${label}": ${err instanceof Error ? err.message : String(err)}`,
|
|
)
|
|
}
|
|
if (!res.ok || !res.body) {
|
|
throw new CliError(`Failed to download "${label}" (status ${res.status}).`)
|
|
}
|
|
try {
|
|
await pipeline(
|
|
Readable.fromWeb(res.body as unknown as WebReadableStream<Uint8Array>),
|
|
createWriteStream(filePath),
|
|
)
|
|
} catch (err) {
|
|
await rm(filePath, { force: true })
|
|
throw new CliError(
|
|
`Failed to save "${label}" to ${filePath}: ${err instanceof Error ? err.message : String(err)}`,
|
|
)
|
|
}
|
|
}
|