@vibedev-si/dsh-vibedev 0.2.6 → 0.3.0

package/lib/tasks/tracker.d.ts

@@ -5,13 +5,21 @@
  * background job, so a task keeps being followed after its job is stopped and
  * after the host restarts.
  *
- * Money rules: a task record is removed only when the first submission was
- * refused outright, so nothing can exist under its key. Every answer that
- * leaves the outcome open (no answer, a gateway error, a 409) keeps the record,
- * and the same request is resent under the same key, which returns the
- * original task when there is one. A resend that is refused outright is
- * retried only briefly, so a refused request is not created later behind the
- * user's back.
+ * Money rules, and the rule that one operation creates at most one task:
+ *
+ * - A submission is settled by the gateway's structured verdict
+ *   (`submission_state` and `retry_action`) first, and only by the HTTP status
+ *   when it sends none. `rejected`/`retry_action: none` is final: the reason is
+ *   saved and nothing is sent again — not by the tool, not by the background
+ *   loop, not after a restart. `retryable` on its own never authorizes creating
+ *   another task.
+ * - An unknown outcome keeps the record and settles it under the SAME key and
+ *   the SAME body, which the gateway answers with the original task when there
+ *   is one. A new key is minted only for a new request the user asks for.
+ * - Once a gateway task id is known the task is only polled; a failed poll
+ *   never submits anything.
+ * - A refusal that left nothing under the key ends the record as failed with
+ *   the gateway's own reason, so the person sees why.
  * @module dsh-vibedev/tasks/tracker
  */
 import type { GatewayHttp } from '../gateway/http.js';
@@ -27,13 +35,12 @@ export interface TrackerOptions {
     readonly sleep?: (ms: number, signal: AbortSignal) => Promise<void>;
     /** Give up on a task this long after it was created. Defaults to 3 hours. */
     readonly maxAgeMs?: number;
-    /** An unconfirmed submission is resent until it is this old. Defaults to 5 minutes. */
-    readonly resendWindowMs?: number;
     /**
-     * A resend refused outright is retried until the task is this old, in case
-     * an earlier attempt is still being created. Defaults to 3 minutes.
+     * How long an unconfirmed submission is reconciled under its own key before
+     * the task is given up. Defaults to 5 minutes: this settles what became of
+     * that one submission, it never creates another task.
      */
-    readonly refusalGraceMs?: number;
+    readonly resendWindowMs?: number;
     /** Download attempts for a finished task before its links are reported instead. Defaults to 5. */
     readonly downloadAttempts?: number;
     /** The largest output downloaded. Defaults to 2 GiB. */
@@ -42,13 +49,34 @@ export interface TrackerOptions {
     readonly claimStaleMs?: number;
 }
 /**
- * Whether a failed submission may still have created the task: no answer, an
- * unreadable answer, a gateway error that is not "busy", or a 409 such as
- * `VIDEO_SUBMISSION_IN_PROGRESS` (an earlier attempt is still being submitted).
+ * How a failed submission may be taken further.
+ *
+ * - `rejected`: the request is refused for good (a parameter refusal, a
+ *   provider-side rejection, a key conflict); nothing exists under the key and
+ *   nothing may be created again for this operation.
+ * - `reconcile`: the outcome is unknown — the same key and the same body are
+ *   sent again only to settle what became of that one submission. This never
+ *   mints a new key and never asks the provider for a new task.
+ * - `wait`: nothing was created and the same request may be sent later (busy,
+ *   rate limited, no balance); the key stays the same.
+ */
+export type SubmissionRecovery = 'rejected' | 'reconcile' | 'wait';
+/**
+ * What a failed submission means.
+ *
+ * The two STOP rules are read before anything that would keep the operation
+ * alive, so no verdict can talk the plugin into sending a refused request
+ * again: `retry_action: none` (the provider refused it) and
+ * `VIDEO_SUBMISSION_AMBIGUOUS` (the gateway's key answers this forever) end the
+ * operation even when the same answer also says the outcome is unknown.
+ *
+ * After those, the gateway's structured verdict decides, and only when it
+ * sends none do the HTTP status and the older codes. `retryable` says recovery
+ * is still needed; it never authorizes creating another task.
  * @param error - the failure.
- * @returns true when the same key should be sent again.
+ * @returns how it may be taken further.
  */
-export declare function outcomeUnknown(error: unknown): boolean;
+export declare function submissionRecovery(error: unknown): SubmissionRecovery;
 /**
  * The live progress line of a running task.
  * @param task - the gateway's view.
@@ -122,6 +150,6 @@ export declare class TaskTracker {
      * shutdown mid-download throws, so the task stays open and is resumed.
      */
     private saveOutputs;
-    /** Download one output: the authenticated `/content` route, then the gateway's no-login link. */
+    /** Use a returned signed URL verbatim and without the app token; old gateways without a URL use `/content`. */
     private fetchOutput;
 }

package/lib/tools/account.d.ts

@@ -9,8 +9,6 @@ import type { ToolDefinition } from '@deepseek-ai/dsh-tools';
 import type { CredentialChain } from '../auth/credentials.js';
 import type { PluginLogin } from '../auth/login.js';
 import type { MediaRuntime } from '../runtime.js';
-/** Where new users register. */
-export declare const REGISTER_URL = "https://vibedev.jzsaas.com";
 /**
  * Build the tool.
  * @param runtime - the media runtime.

package/lib/tools/common.d.ts

@@ -58,7 +58,7 @@ export interface Submitted {
 /**
  * Submit a task and start its report. An unconfirmed submission is not an
  * error here: the agent must not resubmit it, so it is reported like any
- * other task while the tracker resends it under the same key.
+ * other task while the tracker settles that one submission under the same key.
  * @param runtime - the media runtime.
  * @param exec - the tool call.
  * @param draft - the task to submit.

package/lib/video/plan.d.ts

@@ -78,12 +78,15 @@ export declare function checkReferenceFile(model: MediaModel, input: VideoInput,
  */
 export declare function referenceByteLimit(model: MediaModel, input: VideoInput): number;
 /**
- * Check reference video durations once the gateway has measured them.
+ * Check the measured lengths of the reference media once the gateway has
+ * measured them. A reference's OWN length is what is checked — never the
+ * requested output duration — and only against the limits that model declares.
  * @param model - the video model.
  * @param videos - the uploaded reference videos, in order.
+ * @param audios - the uploaded reference audios, 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;
+export declare function checkReferenceDurations(model: MediaModel, videos: readonly ReferenceMedia[], audios?: readonly ReferenceMedia[]): void;
 /**
  * The `/v1/videos` body for a plan whose inputs are uploaded. The gateway reads
  * one vocabulary and translates it per provider.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibedev-si/dsh-vibedev",
-  "version": "0.2.6",
+  "version": "0.3.0",
   "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",