@vibedev-si/dsh-vibedev 0.2.1

package/lib/util/files.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Files the plugin writes: its state directory, output names in the
+ * workspace, and atomic writes of generated media. Content is written to a
+ * temporary file first and moved into place only when complete, so a crash
+ * never leaves a half-written or empty file under a final name.
+ * @module dsh-vibedev/util/files
+ */
+/**
+ * The harness home: `$DSH_HOME` when set (VibeDev sets it to its own home),
+ * else `~/.dsh`, the same rule the harness itself applies.
+ * @param env - the environment.
+ * @returns the absolute home directory.
+ */
+export declare function harnessHome(env?: Readonly<Record<string, string | undefined>>): string;
+/**
+ * The plugin's own state directory: the configured one, else `<harness home>/dsh-media`
+ * (the plugin's former name, kept so an upgrade keeps its tasks and device id).
+ * @param configured - the `stateDir` setting; empty for the default.
+ * @param env - the environment.
+ * @returns the absolute directory.
+ */
+export declare function stateDirectory(configured: string, env?: Readonly<Record<string, string | undefined>>): string;
+/**
+ * A file-name stem from free text: characters no file system accepts are
+ * dropped, whitespace becomes `-`, and the result is cut to `max` characters.
+ * @param text - a prompt or a requested name.
+ * @param max - the longest stem, in characters.
+ * @returns the stem, possibly empty.
+ */
+export declare function safeStem(text: string, max?: number): string;
+/**
+ * A sortable local timestamp for file names (`20261003-165012`).
+ * @param date - the moment.
+ * @returns the timestamp.
+ */
+export declare function fileTimestamp(date: Date): string;
+/**
+ * Rename, retrying the transient refusals Windows gives while a virus scanner
+ * or the indexer holds the file.
+ * @param from - the current path.
+ * @param to - the new path; an existing file is replaced.
+ */
+export declare function renameWithRetry(from: string, to: string): Promise<void>;
+/**
+ * Move a complete temporary file to the first free name `dir/stem.ext`
+ * (then `stem-2.ext`, ...), never replacing an existing file.
+ * @param temporary - the complete file.
+ * @param dir - the destination directory, created when missing.
+ * @param stem - the file-name stem.
+ * @param extension - the extension, without a dot.
+ * @returns the final path.
+ */
+export declare function placeFile(temporary: string, dir: string, stem: string, extension: string): Promise<string>;
+/**
+ * Save bytes under the first free name `dir/stem.ext`.
+ * @param dir - the destination directory.
+ * @param stem - the file-name stem.
+ * @param extension - the extension, without a dot.
+ * @param data - the content.
+ * @returns the final path.
+ */
+export declare function saveNewFile(dir: string, stem: string, extension: string, data: Uint8Array): Promise<string>;
+/**
+ * Write bytes atomically, replacing the file.
+ * @param path - the final path.
+ * @param data - the content.
+ * @param options - `mode` for a file only its owner may read.
+ */
+export declare function writeFileAtomic(path: string, data: Uint8Array, options?: {
+    mode?: number;
+}): Promise<void>;
+/**
+ * Stream a response body into a temporary file, replacing what was there.
+ * @param response - a successful response whose body is unread.
+ * @param temporary - where to write; the caller moves it into place when this resolves.
+ * @param maxBytes - the largest accepted body.
+ * @param signal - cancels the download.
+ * @returns the number of bytes written.
+ */
+export declare function downloadTo(response: Response, temporary: string, maxBytes: number, signal?: AbortSignal): Promise<number>;

package/lib/video/plan.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Video request planning: choose the generation mode, check every input and
+ * option against what the chosen model declares, and build the request body.
+ * Everything here runs before anything is uploaded or charged, so a request the
+ * model cannot serve fails with a message that lists what it can.
+ * @module dsh-vibedev/video/plan
+ */
+import type { MediaModel, VideoInput, VideoMode, VideoModeConstraint } from '../gateway/catalog.js';
+/** What the caller asks for. Sources are workspace paths or URLs. */
+export interface VideoRequestOptions {
+    readonly prompt: string;
+    readonly mode?: VideoMode;
+    readonly duration?: number;
+    readonly aspectRatio?: string;
+    readonly resolution?: string;
+    readonly generateAudio?: boolean;
+    readonly firstFrame?: string;
+    readonly lastFrame?: string;
+    readonly referenceImages?: readonly string[];
+    readonly referenceVideos?: readonly string[];
+    readonly referenceAudios?: readonly string[];
+}
+/** A checked request, ready for its inputs to be uploaded. */
+export interface VideoPlan {
+    readonly mode: VideoMode;
+    readonly constraint: VideoModeConstraint;
+    readonly duration?: number;
+    readonly aspectRatio?: string;
+    readonly resolution?: string;
+    readonly generateAudio?: boolean;
+    /** Sources per input, in the caller's order. */
+    readonly inputs: Partial<Record<VideoInput, readonly string[]>>;
+}
+/** The media kind each input carries. */
+export declare const INPUT_KIND: Readonly<Record<VideoInput, 'image' | 'video' | 'audio'>>;
+/** The `video_generate` parameter each input arrives in; messages name inputs by it. */
+export declare const INPUT_PARAM: Readonly<Record<VideoInput, string>>;
+/** MIME types the gateway accepts for hosted references when the catalog names none. */
+export declare const DEFAULT_REFERENCE_MIMES: Readonly<Record<'image' | 'video' | 'audio', readonly string[]>>;
+/** The gateway media library's default per-file ceiling. */
+export declare const MEDIA_LIBRARY_MAX_BYTES: number;
+/**
+ * A one-paragraph account of what a video model accepts, for errors and model listings.
+ * @param model - the video model.
+ * @returns the description.
+ */
+export declare function describeVideoModel(model: MediaModel): string;
+/**
+ * Check a request against the model and fix its mode and options.
+ * @param model - the chosen video model.
+ * @param options - prompt, mode, options and input sources.
+ * @returns the plan.
+ * @throws {@link MediaError} naming what the model supports.
+ */
+export declare function planVideo(model: MediaModel, options: VideoRequestOptions): VideoPlan;
+/** One reference's facts, as loaded or uploaded. */
+export interface ReferenceMedia {
+    readonly source: string;
+    readonly mime: string;
+    readonly bytes: number;
+    /** Measured duration of an uploaded audio or video, in milliseconds. */
+    readonly durationMs?: number;
+}
+/**
+ * Check one reference's format and size before it is uploaded.
+ * @param model - the video model.
+ * @param input - which input it fills.
+ * @param media - its type and size.
+ * @throws {@link MediaError} when the model or the gateway would refuse it.
+ */
+export declare function checkReferenceFile(model: MediaModel, input: VideoInput, media: ReferenceMedia): void;
+/**
+ * The largest file one input may be: the model's per-kind limit, its asset
+ * limit and the media library ceiling, whichever is smallest.
+ * @param model - the video model.
+ * @param input - which input.
+ * @returns the limit in bytes.
+ */
+export declare function referenceByteLimit(model: MediaModel, input: VideoInput): number;
+/**
+ * Check reference video durations once the gateway has measured them.
+ * @param model - the video model.
+ * @param videos - the uploaded reference videos, in order.
+ * @throws {@link MediaError} when a clip or the total is outside the model's limits.
+ */
+export declare function checkReferenceDurations(model: MediaModel, videos: readonly ReferenceMedia[]): void;
+/**
+ * The `/v1/videos` body for a plan whose inputs are uploaded. The gateway reads
+ * one vocabulary and translates it per provider.
+ * @param model - the model id.
+ * @param prompt - the prompt.
+ * @param plan - the checked plan.
+ * @param urls - the gateway reference URL of every input, in order.
+ * @returns the request body.
+ */
+export declare function videoRequestBody(model: string, prompt: string, plan: VideoPlan, urls: Partial<Record<VideoInput, readonly string[]>>): Record<string, unknown>;

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "VibeDev Account & Models",
+    "description": "Sign in to VibeDev (next to the DeepSeek account) to use the VibeDev gateway's models (Claude, GPT and more) in the model picker, and let the agent generate images, videos, music and podcasts and transcribe speech; paid from your VibeDev balance."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "VibeDev 账号与模型",
+    "description": "登录 VibeDev 账号（与 DeepSeek 账号并存），在模型选择器里使用 VibeDev 网关的模型（Claude、GPT 等），并让 Agent 生成图片、视频、音乐和播客、转写语音；费用从 VibeDev 余额扣除。"
+  }
+}

package/package.json

@@ -0,0 +1,127 @@
+{
+  "name": "@vibedev-si/dsh-vibedev",
+  "version": "0.2.1",
+  "description": "VibeDev 账号与模型：在 DeepSeek Harness 里登录 VibeDev，与 DeepSeek 账号并存，使用 VibeDev 网关的模型（Claude、GPT 等），并生成图片、视频、音乐和播客 · VibeDev account and models for DeepSeek Harness: sign in to VibeDev next to the DeepSeek account and use the VibeDev gateway's models (Claude, GPT and more), plus image, video, music and podcast generation",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "icon": "./icon.svg",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": "./client/client.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json",
+    "./locale/*.json": "./locale/*.json"
+  },
+  "files": [
+    "lib",
+    "client",
+    "locale",
+    "icon.svg",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE",
+    "THIRD-PARTY-NOTICES.txt"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-plugin-manager",
+        "@deepseek-ai/dsh-client-ui-sidebar"
+      ]
+    }
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "vibedev",
+    "vibedev-account",
+    "llm",
+    "claude",
+    "gpt",
+    "image-generation",
+    "video-generation",
+    "music-generation",
+    "speech-to-text"
+  ],
+  "homepage": "https://github.com/VibeDev-Si/dsh-vibedev#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/VibeDev-Si/dsh-vibedev.git"
+  },
+  "bugs": {
+    "url": "https://github.com/VibeDev-Si/dsh-vibedev/issues"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "scripts": {
+    "clean": "node scripts/clean.mjs",
+    "build": "npm run clean && npm run build:host && npm run build:types && npm run build:client && npm run build:notices",
+    "build:host": "tsdown -c tsdown.host.config.ts",
+    "build:types": "tsc -p tsconfig.build.json --emitDeclarationOnly",
+    "build:client": "tsdown && node scripts/normalize-client.mjs",
+    "build:notices": "node scripts/third-party-notices.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.client.json",
+    "test": "vitest run",
+    "check:package": "node scripts/check-package.mjs",
+    "prepack": "npm run build && npm run check:package"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-attachment": ">=0.2.0-rc.2 <0.3.0",
+    "@deepseek-ai/dsh-brand": ">=0.2.0-rc.2 <0.3.0",
+    "@deepseek-ai/dsh-credentials": ">=0.2.0-rc.2 <0.3.0",
+    "@deepseek-ai/dsh-llm": ">=0.2.0-rc.2 <0.3.0",
+    "@deepseek-ai/dsh-timeout": ">=0.2.0-rc.2 <0.3.0",
+    "@deepseek-ai/dsh-tools": ">=0.2.0-rc.2 <0.3.0",
+    "@deepseek-ai/dsh-web": ">=0.2.0-rc.2 <0.3.0",
+    "@deepseek-ai/schemastery": "^3.18.2"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "4.0.4",
+    "@deepseek-ai/dsh-agent": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-attachment": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-brand": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-connection": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-store": "^0.2.0-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.2.0-rc.2",
+    "@deepseek-ai/dsh-credentials": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-deepseek-account": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-fs": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-jobs": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-llm": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-session": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-settings": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-system-prompt": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-timeout": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-tools": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-user-approval": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-web": "0.2.0-rc.2",
+    "@deepseek-ai/schemastery": "3.18.4",
+    "@earendil-works/pi-ai": "0.87.1",
+    "@types/node": "^22.10.0",
+    "@types/react": "^18.3.12",
+    "@types/react-dom": "^18.3.1",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "tsdown": "^0.22.14",
+    "typescript": "~5.9.3",
+    "vitest": "^4.1.8"
+  }
+}