feat(task): give polling hooks a real query context, host HTTP classification,…

feat(task): give polling hooks a real query context, host HTTP classification, and bounded poll failures Plugin polling hooks previously ran against a hollow context: parseTaskResult and parseBatchResult received {} / nil, buildQueryRequest received a {task_id, action} map under the misleading name requestBody, and batch hooks saw only bare task ids. The per-task poller also never looked at the upstream HTTP status, and every built-in plugin papered over unrecognized bodies with `|| "IN_PROGRESS"`, so a 404, a revoked key, or a shape the plugin did not know would sit in IN_PROGRESS for the full 24h TASK_TIMEOUT_MINUTES while holding the user's pre-charged quota. Contract (docs/plugin-api v1.d.ts, v1.md, v1.schema.json): - TaskQueryContext is declared separately from DriverContext and rebuilt from the persisted Task row: taskId, publicTaskId, action, model, upstreamModel, baseUrl, apiKey, authHeader, auth, data, state. Query-side requestBody is removed; the original request is not persisted and hooks that need a request-derived value must save it into state at submit time. - parseTaskResult / parseBatchResult receive a third {status, headers} argument. Batch hooks receive tasks[] with one TaskQueryContext per task. - NormalizedTaskResult accepts status "UNKNOWN" meaning "I do not recognize this body". Falling back to IN_PROGRESS for unknown shapes is forbidden; `plugin lint` warns on the literal. - parseSubmitResponse / parseTaskResult / parseBatchResult may return `state`. Task.Data remains a per-round snapshot overwritten on every valid parse; state is plugin-owned, persisted in TaskPrivateData.PluginState, preserved when a hook omits it, byte-capped like taskData, and never exposed through presenter views. Host (service/task_polling.go, relay/channel/task/jsplugin/adaptor.go): - TaskPollingAdaptor / BatchTaskPollingAdaptor take *model.Task and the *http.Response so the adaptor can build the full context; jsplugin is the only implementation. - HTTP classification before the plugin sees the body: 2xx -> plugin; 404/410 -> FAILURE and refund; 401/403 -> poll failure plus a channel-scoped warning, no auto-disable; 429/5xx/transport -> poll failure; other 4xx -> plugin with the status visible, counted as unrecognized if the plugin still reports a non-terminal state. - TaskPrivateData.PollFailures counts consecutive poll failures (transient HTTP, auth, transport, hook error, UNKNOWN). It is persisted through the existing UpdateWithStatus CAS so a concurrent terminal transition on another instance is never clobbered, and reset on any valid 2xx non-terminal parse. Reaching TASK_POLL_MAX_FAILURES (default 20, <= 0 disables) fails the task with the last classification and HTTP code in fail_reason and runs the existing settle/refund chain exactly once. sweepTimedOutTasks and its 1440-minute default are unchanged as the outer backstop. - Unrecognized bodies are logged at WARN with a bounded redacted copy since Task.Data is intentionally not overwritten on that path. Plugins (all ten bumped one patch version): - jimeng persists the outbound req_key in state and reads it back in buildQueryRequest, replacing dead reads of ctx.data / ctx.requestBody that never resolved. - sunoapi batch hooks read tasks[] instead of the removed requestBody. - hailuo treats base_resp.status_code != 0 as FAILURE before the status table. - kling, vidu, sora, alibaba, doubao, hailuo, jimeng return UNKNOWN with the raw upstream status in reason on table miss. - google and vertex-ai treat a missing `done` as in-progress: Google long-running operations omit proto3 default fields, so a running Veo operation has no `done` key at all. Only a body without an operation name is UNKNOWN. plugins/veo_poll_test.go locks this so the poll-failure cutoff can never fail a rendering Veo task. Tests cover the classification table end to end against a real DB (404 immediate refund, 429xN refund, 401 increments without status change, 2xx reset, UNKNOWN increments, state preserved vs replaced, PollFailures survives the CAS write), the query-context shape, UNKNOWN on unrecognized bodies, and the absence of PluginState/PollFailures from TaskView. Controller tests derive the kling factory version from the embedded manifest instead of hardcoding it.

feat(task): give polling hooks a real query context, host HTTP classification,…
feat(task): give polling hooks a real query context, host HTTP classification, and bounded poll failures Plugin polling hooks previously ran against a hollow context: parseTaskResult and parseBatchResult received {} / nil, buildQueryRequest received a {task_id, action} map under the misleading name requestBody, and batch hooks saw only bare task ids. The per-task poller also never looked at the upstream HTTP status, and every built-in plugin papered over unrecognized bodies with `|| "IN_PROGRESS"`, so a 404, a revoked key, or a shape the plugin did not know would sit in IN_PROGRESS for the full 24h TASK_TIMEOUT_MINUTES while holding the user's pre-charged quota. Contract (docs/plugin-api v1.d.ts, v1.md, v1.schema.json): - TaskQueryContext is declared separately from DriverContext and rebuilt from the persisted Task row: taskId, publicTaskId, action, model, upstreamModel, baseUrl, apiKey, authHeader, auth, data, state. Query-side requestBody is removed; the original request is not persisted and hooks that need a request-derived value must save it into state at submit time. - parseTaskResult / parseBatchResult receive a third {status, headers} argument. Batch hooks receive tasks[] with one TaskQueryContext per task. - NormalizedTaskResult accepts status "UNKNOWN" meaning "I do not recognize this body". Falling back to IN_PROGRESS for unknown shapes is forbidden; `plugin lint` warns on the literal. - parseSubmitResponse / parseTaskResult / parseBatchResult may return `state`. Task.Data remains a per-round snapshot overwritten on every valid parse; state is plugin-owned, persisted in TaskPrivateData.PluginState, preserved when a hook omits it, byte-capped like taskData, and never exposed through presenter views. Host (service/task_polling.go, relay/channel/task/jsplugin/adaptor.go): - TaskPollingAdaptor / BatchTaskPollingAdaptor take *model.Task and the *http.Response so the adaptor can build the full context; jsplugin is the only implementation. - HTTP classification before the plugin sees the body: 2xx -> plugin; 404/410 -> FAILURE and refund; 401/403 -> poll failure plus a channel-scoped warning, no auto-disable; 429/5xx/transport -> poll failure; other 4xx -> plugin with the status visible, counted as unrecognized if the plugin still reports a non-terminal state. - TaskPrivateData.PollFailures counts consecutive poll failures (transient HTTP, auth, transport, hook error, UNKNOWN). It is persisted through the existing UpdateWithStatus CAS so a concurrent terminal transition on another instance is never clobbered, and reset on any valid 2xx non-terminal parse. Reaching TASK_POLL_MAX_FAILURES (default 20, <= 0 disables) fails the task with the last classification and HTTP code in fail_reason and runs the existing settle/refund chain exactly once. sweepTimedOutTasks and its 1440-minute default are unchanged as the outer backstop. - Unrecognized bodies are logged at WARN with a bounded redacted copy since Task.Data is intentionally not overwritten on that path. Plugins (all ten bumped one patch version): - jimeng persists the outbound req_key in state and reads it back in buildQueryRequest, replacing dead reads of ctx.data / ctx.requestBody that never resolved. - sunoapi batch hooks read tasks[] instead of the removed requestBody. - hailuo treats base_resp.status_code != 0 as FAILURE before the status table. - kling, vidu, sora, alibaba, doubao, hailuo, jimeng return UNKNOWN with the raw upstream status in reason on table miss. - google and vertex-ai treat a missing `done` as in-progress: Google long-running operations omit proto3 default fields, so a running Veo operation has no `done` key at all. Only a body without an operation name is UNKNOWN. plugins/veo_poll_test.go locks this so the poll-failure cutoff can never fail a rendering Veo task. Tests cover the classification table end to end against a real DB (404 immediate refund, 429xN refund, 401 increments without status change, 2xx reset, UNKNOWN increments, state preserved vs replaced, PollFailures survives the CAS write), the query-context shape, UNKNOWN on unrecognized bodies, and the absence of PluginState/PollFailures from TaskView. Controller tests derive the kling factory version from the embedded manifest instead of hardcoding it.
9df450fe · CaIon · 9f506dd7 · 9df450fe · 9df450fe · 9df450fe
Commit 9df450fe authored Sep 03, 2026 by CaIon
36 changed files
--- a/.env.example
+++ b/.env.example
@@ -56,6 +56,10 @@
 # 任务和功能配置
 # 更新任务启用
 # UPDATE_TASK=true
+# 异步任务硬超时（分钟），按提交时间计算，超时未完成的任务标记失败并退款；0 表示禁用
+# TASK_TIMEOUT_MINUTES=1440
+# 异步任务连续轮询失败阈值（上游 429/5xx/401/403、网络错误、无法识别的响应），达到后任务标记失败并退款；正常轮询成功一次即归零
+# TASK_POLL_MAX_FAILURES=20
 # 对话超时设置
 # 所有请求超时时间，单位秒，默认为0，表示不限制

--- a/common/init.go
+++ b/common/init.go
@@ -202,6 +202,8 @@ func initConstantEnv() {
 	constant.TaskQueryLimit = GetEnvOrDefault("TASK_QUERY_LIMIT", 1000)
 	// 异步任务超时时间（分钟），超过此时间未完成的任务将被标记为失败并退款。0 表示禁用。
 	constant.TaskTimeoutMinutes = GetEnvOrDefault("TASK_TIMEOUT_MINUTES", 1440)
+	// Consecutive unrecognized/transient poll failures before the task is failed and refunded.
+	constant.TaskPollMaxFailures = GetEnvOrDefault("TASK_POLL_MAX_FAILURES", 20)
 	// 声明式任务协议桥只观察数据库；这些值控制一次客户端观察连接，
 	// 不改变后台轮询或结算生命周期。
 	constant.TaskPluginProtocolTimeoutSeconds = GetEnvOrDefault("TASK_PLUGIN_PROTOCOL_TIMEOUT_SECONDS", 600)

--- a/constant/env.go
+++ b/constant/env.go
@@ -18,6 +18,7 @@ var GenerateDefaultToken bool
 var ErrorLogEnabled bool
 var TaskQueryLimit int
 var TaskTimeoutMinutes int
+var TaskPollMaxFailures = 20
 var TaskPluginProtocolTimeoutSeconds int
 var TaskPluginProtocolTickMilliseconds int
 var TaskPluginProtocolTickJitterMilliseconds int

--- a/controller/plugin_protocol_test.go
+++ b/controller/plugin_protocol_test.go
@@ -366,14 +366,14 @@ type terminalSettlementPollingAdaptor struct {
 func (a *terminalSettlementPollingAdaptor) Init(*relaycommon.RelayInfo) {}
-func (a *terminalSettlementPollingAdaptor) FetchTask(string, string, map[string]any, string) (*http.Response, error) {
+func (a *terminalSettlementPollingAdaptor) FetchTask(string, string, *model.Task, string) (*http.Response, error) {
 	return &http.Response{
 		StatusCode: http.StatusOK,
 		Body:       io.NopCloser(strings.NewReader(`{}`)),
 	}, nil
 }
-func (a *terminalSettlementPollingAdaptor) ParseTaskResult([]byte) (*relaycommon.TaskInfo, error) {
+func (a *terminalSettlementPollingAdaptor) ParseTaskResult(*model.Task, *http.Response, []byte) (*relaycommon.TaskInfo, error) {
 	return &relaycommon.TaskInfo{
 		Status:   model.TaskStatusSuccess,
 		Progress: "100%",

--- a/controller/relay.go
+++ b/controller/relay.go
@@ -744,6 +744,9 @@ func executeTaskSubmissionWith(
 	}
 	task.Quota = result.Quota
 	task.Data = result.TaskData
+	if len(result.PluginState) > 0 {
+		task.PrivateData.PluginState = result.PluginState
+	}
 	task.Action = relayInfo.Action
 	if immediate := result.Immediate; immediate != nil {
 		task.Status = model.TaskStatus(immediate.Status)

--- a/controller/task_plugin_test.go
+++ b/controller/task_plugin_test.go
@@ -5,6 +5,7 @@ import (
 	"fmt"
 	"net/http"
 	"net/http/httptest"
+	"regexp"
 	"strings"
 	"testing"
@@ -117,6 +118,17 @@ func TestDisableThirdPartyPluginSupportsCascadeAndForce(t *testing.T) {
 	assert.Equal(t, common.ChannelStatusManuallyDisabled, updated.Status)
 }
+// klingFactoryVersion returns the version declared in the embedded kling factory
+// manifest so tests do not hardcode a value that moves with every plugin release.
+func klingFactoryVersion(t *testing.T) string {
+	t.Helper()
+	factorySource, err := plugins.Source("kling")
+	require.NoError(t, err)
+	match := regexp.MustCompile(`version:\s*"([^"]+)"`).FindStringSubmatch(factorySource)
+	require.Len(t, match, 2, "kling factory manifest must declare a version")
+	return match[1]
+}
 func setupTaskPluginFactoryDisableTest(t *testing.T) {
 	t.Helper()
 	setupTaskPluginControllerTest(t)
@@ -240,7 +252,9 @@ func TestDisableFactoryOverrideRowKeepsEnabledFlagPath(t *testing.T) {
 	setupTaskPluginFactoryDisableTest(t)
 	factorySource, err := plugins.Source("kling")
 	require.NoError(t, err)
-	overrideSource := strings.Replace(factorySource, `version: "1.0.0"`, `version: "1.0.0-test-factory-status"`, 1)
+	factoryVersion := klingFactoryVersion(t)
+	overrideSource := strings.Replace(factorySource, `version: "`+factoryVersion+`"`, `version: "`+factoryVersion+`-test-factory-status"`, 1)
+	require.NotEqual(t, factorySource, overrideSource, "factory version marker must be found in kling source")
 	loaded, err := jsplugin.DefaultRegistry.Register(overrideSource, jsplugin.Options{})
 	require.NoError(t, err)
 	t.Cleanup(func() { jsplugin.DefaultRegistry.Unregister("kling") })
@@ -266,7 +280,7 @@ func TestDisableFactoryOverrideRowKeepsEnabledFlagPath(t *testing.T) {
 	assert.True(t, taskPluginOptionsHasKey(t, "kling"))
 	got, ok := jsplugin.DefaultRegistry.Get("kling")
 	require.True(t, ok)
-	assert.Equal(t, "1.0.0", got.Meta.Version)
+	assert.Equal(t, factoryVersion, got.Meta.Version)
 }
 func TestListTaskPluginsIncludesFactoryWithoutDatabaseRows(t *testing.T) {
@@ -358,7 +372,9 @@ func TestListTaskPluginsShowsDisabledFallbackWhenOverridesAreDisabled(t *testing
 	setupTaskPluginControllerTest(t)
 	factorySource, err := plugins.Source("kling")
 	require.NoError(t, err)
-	overrideSource := strings.Replace(factorySource, `version: "1.0.0"`, `version: "1.0.0-test-disabled-override"`, 1)
+	factoryVersion := klingFactoryVersion(t)
+	overrideSource := strings.Replace(factorySource, `version: "`+factoryVersion+`"`, `version: "`+factoryVersion+`-test-disabled-override"`, 1)
+	require.NotEqual(t, factorySource, overrideSource, "factory version marker must be found in kling source")
 	loaded, err := jsplugin.DefaultRegistry.Register(overrideSource, jsplugin.Options{})
 	require.NoError(t, err)
 	plugin := model.TaskPlugin{
@@ -399,7 +415,9 @@ func TestDeleteActiveOverrideFallsBackToFactoryAndDeletesRecord(t *testing.T) {
 	setupTaskPluginControllerTest(t)
 	factorySource, err := plugins.Source("kling")
 	require.NoError(t, err)
-	overrideSource := strings.Replace(factorySource, `version: "1.0.0"`, `version: "1.0.0-test-override"`, 1)
+	factoryVersion := klingFactoryVersion(t)
+	overrideSource := strings.Replace(factorySource, `version: "`+factoryVersion+`"`, `version: "`+factoryVersion+`-test-override"`, 1)
+	require.NotEqual(t, factorySource, overrideSource, "factory version marker must be found in kling source")
 	loaded, err := jsplugin.DefaultRegistry.Register(overrideSource, jsplugin.Options{Key: "kling", Version: "test-override"})
 	require.NoError(t, err)
 	t.Cleanup(func() { jsplugin.DefaultRegistry.Unregister("kling") })

--- a/docs/plugin-api/v1.d.ts
+++ b/docs/plugin-api/v1.d.ts
@@ -25,6 +25,9 @@ export type UsageExample = {label: string; facts: Readonly<Record<string, string
 export interface Meta {apiVersion: 1; key: string; name: string; icon?: string; description?: LocalizedText; version: string; author: {name: string; url?: string}; channelTypes?: readonly number[]; models: readonly string[]; fetchMode: "per_task" | "batch"; allowedHosts?: readonly string[]; routes?: readonly NativeRoute[]; protocols?: readonly ProtocolClaim[]; usageSchema?: Readonly<Record<string, UsageFieldSchema>>; usageExamples?: readonly UsageExample[]; auth?: "none" | "api_key" | "vertex_oauth" | {type: "none" | "api_key" | "oauth2_jwt"}}
 export interface TaskView {task_id: string; status: string; progress?: string; fail_reason?: string; created_at?: number; updated_at?: number; data?: unknown; properties?: Record<string, unknown>}
 export interface DriverContext {requestBody: unknown; requestHeaders: Readonly<Record<string, string>>; action: string; model: string; upstreamModel: string; baseUrl: string; apiKey?: string; authHeader: string; files: readonly FileReference[]; publicTaskId: string; originTasks?: readonly {taskId: string; upstreamTaskId: string; action: string; status: string; data: unknown}[]}
+export interface TaskQueryContext {taskId: string; publicTaskId: string; action: string; model: string; upstreamModel: string; baseUrl: string; apiKey?: string; authHeader: string; auth?: unknown; data: unknown; state: unknown}
+export interface BatchQueryContext {baseUrl: string; apiKey?: string; authHeader: string; auth?: unknown; tasks: readonly TaskQueryContext[]}
+export type HookHTTPResponse = {readonly status: number; readonly headers: Readonly<Record<string, string>>}
 export interface RequestDescriptor {url: string; method?: string; headers?: Record<string, string>; /** JSON body may contain FilePlaceholder objects at any depth; the host replaces each with a Base64 or data-URL string. */ body?: unknown; credentialless?: boolean; action?: string; model?: string; rewriteModel?: string; bodyType?: "json" | "multipart"; parts?: readonly {name: string; value?: unknown; fileRef?: string; filename?: string}[]}
 export interface UpstreamResponse {statusCode: number; headers: Readonly<Record<string, readonly string[]>>; body: unknown}
 export interface NormalizedTaskResult {taskId?: string; status: "NOT_START" | "SUBMITTED" | "QUEUED" | "IN_PROGRESS" | "SUCCESS" | "FAILURE" | "UNKNOWN"; progress?: string; reason?: string; url?: string; remoteUrl?: string; completionTokens?: number; totalTokens?: number}
@@ -36,13 +39,13 @@ export declare const protocols: {
  openai_video?: {decodeRequest(ctx: ProtocolDecodeContext): SubmitIntent; render(ctx: unknown, task: TaskView): unknown};
 };
 export declare function buildSubmitRequest(ctx: DriverContext): RequestDescriptor;
-export declare function parseSubmitResponse(ctx: DriverContext, response: UpstreamResponse): {taskId: string; taskData?: unknown; immediate?: NormalizedTaskResult};
+export declare function parseSubmitResponse(ctx: DriverContext, response: UpstreamResponse): {taskId: string; taskData?: unknown; immediate?: NormalizedTaskResult; state?: unknown};
-export declare function buildQueryRequest(ctx: DriverContext & {taskId: string}): RequestDescriptor;
+export declare function buildQueryRequest(ctx: TaskQueryContext): RequestDescriptor;
-export declare function buildBatchQueryRequest(ctx: DriverContext, taskIds: readonly string[]): RequestDescriptor;
+export declare function buildBatchQueryRequest(ctx: BatchQueryContext, tasks: readonly TaskQueryContext[]): RequestDescriptor;
-export declare function parseTaskResult(ctx: DriverContext, body: unknown): NormalizedTaskResult;
+export declare function parseTaskResult(ctx: TaskQueryContext, body: unknown, response: HookHTTPResponse): NormalizedTaskResult;
-export declare function parseBatchResult(ctx: DriverContext, body: unknown): readonly (NormalizedTaskResult & {taskId: string; data?: unknown})[];
+export declare function parseBatchResult(ctx: BatchQueryContext, body: unknown, response: HookHTTPResponse): readonly (NormalizedTaskResult & {taskId: string; data?: unknown; state?: unknown})[];
 export declare function extractUsage(ctx: DriverContext & {usagePurpose?: "facts" | "billing_ratios"}): Readonly<Record<string, string | number | boolean>> | null;
 export declare function extractUsageOnSubmit(ctx: DriverContext, taskData: unknown): Readonly<Record<string, string | number | boolean>> | null;
 export declare function extractUsageOnComplete(task: TaskView, result: NormalizedTaskResult, data: unknown): Readonly<Record<string, string | number | boolean>> | null;
 export declare function listArtifacts(task: {taskId: string; status: string; action: string; data: unknown; producerVersion: string}): readonly TaskArtifact[];
-export declare function buildContentRequest(ctx: DriverContext & {artifactKey: string; data: unknown; upstreamTaskId: string; clientRequest: {method: "GET" | "HEAD"; headers: Readonly<Record<string, string>>}}): RequestDescriptor;
+export declare function buildContentRequest(ctx: DriverContext & {artifactKey: string; data: unknown; state?: unknown; upstreamTaskId: string; clientRequest: {method: "GET" | "HEAD"; headers: Readonly<Record<string, string>>}}): RequestDescriptor;
--- a/docs/plugin-api/v1.md
+++ b/docs/plugin-api/v1.md
@@ -32,7 +32,7 @@ Each `protocols` entry claims a host protocol. A protocol that defines modes mus
 Enabled uploads pre-flight the candidate against the live routing generation and reject the first channel-type, native-route, or protocol-model conflict (the error names the counterpart plugin). Set `force: true` or `enabled: false` to store the plugin anyway.
-`endpoints`, `routes[].renderer`, global `resolveRequest`, global `renderError`, and global `renderers` are rejected. `parseSubmitResponse` returns only `{taskId, taskData}` (plus the documented lifecycle fields); `clientResponse` is rejected.
+`endpoints`, `routes[].renderer`, global `resolveRequest`, global `renderError`, and global `renderers` are rejected. `parseSubmitResponse` returns only `{taskId, taskData, immediate?, state?}`; `clientResponse` is rejected.
 `icon` is an optional LobeHub icon name string (for example `Sora.Color`). The values `text` and `text:<label>` request a generated text avatar instead (label defaults to the first two characters of `name`). It is display-only and does not participate in routing, billing, or admission beyond type and length checks.
@@ -140,3 +140,38 @@ Protocol media uses host-injected `ctx.artifacts[key].url`. Provider URLs from `
 The persisted field remains `task.data`; there is no `task.raw` alias. Driver hooks (`buildSubmitRequest`, `parseSubmitResponse`, query/result, usage, artifact, and content hooks) stay flat and must not branch on the client path or protocol.
 `ctx.model` is the billing and display identity (the origin name the client sent, including a channel-mapping alias). `ctx.upstreamModel` is the machine identity after channel `model_mapping`. Rate tables and model-keyed usage facts must use `ctx.upstreamModel || ctx.model`. Decode and render hooks that echo the client model must keep `ctx.model`. `buildSubmitRequest` must not set descriptor top-level `model` on a mapped pin; the host requires the plugin to echo the alias verbatim. Background polling has no relay info, so query hooks receive both identities from the persisted task properties, and `ctx.upstreamModel` falls back to `ctx.model` when the task was submitted without a channel mapping.
+## Polling contract
+Query and parse hooks use `TaskQueryContext`, not `DriverContext`. The host rebuilds that context from the persisted task row. There is no query-side `requestBody`.
+| Field | Source |
+|-------|--------|
+| `taskId` | Upstream task id (`PrivateData.UpstreamTaskID`, else `TaskID`) |
+| `publicTaskId` | Gateway task id |
+| `action` | Normalized persisted action |
+| `model` | `Properties.OriginModelName` |
+| `upstreamModel` | `Properties.UpstreamModelName`, falling back to `model` |
+| `baseUrl` / `apiKey` / `authHeader` / `auth` | Channel credentials |
+| `data` | Current `Task.Data` snapshot |
+| `state` | Plugin-owned `PrivateData.PluginState` |
+`Task.Data` is the latest upstream response snapshot for presenters and artifacts. The host overwrites it on every successful parse. Values that must survive across poll rounds belong in `state`.
+`parseSubmitResponse`, `parseTaskResult`, and each `parseBatchResult` item may return optional `state`. The host writes it only when the hook returns it. Omitting `state` preserves the previous value. Oversized state is rejected with a warning, not truncated.
+`buildBatchQueryRequest(ctx, tasks)` and `parseBatchResult` receive `tasks: TaskQueryContext[]`. `parseTaskResult` / `parseBatchResult` also receive `{status, headers}` for the upstream HTTP response.
+`status: "UNKNOWN"` means the plugin does not recognize the response. Do not write `|| "IN_PROGRESS"` (or equivalent) for a missing table entry. The host treats `UNKNOWN`, hook errors, empty status, and unrecognized status strings as consecutive poll failures.
+The host classifies the HTTP status before trusting a non-terminal parse:
+| Upstream HTTP | Host action |
+|---------------|-------------|
+| 2xx | Call the parse hook |
+| 404 / 410 | Immediate `FAILURE` and refund |
+| 401 / 403 | Leave task status unchanged; increment `PollFailures`; `LogWarn` with channel id. Channels are not auto-disabled. |
+| 429 / 5xx / transport error | Increment `PollFailures` |
+| Other 4xx | Call the parse hook with `response.status`. A still-non-terminal result is unrecognized and increments `PollFailures`. |
+A valid 2xx non-terminal parse resets `PollFailures` to 0. After `TASK_POLL_MAX_FAILURES` (default 20) consecutive failures the task becomes `FAILURE` and follows the existing refund chain. The 24h `TASK_TIMEOUT_MINUTES` sweep remains the outer deadline.
--- a/docs/plugin-api/v1.schema.json
+++ b/docs/plugin-api/v1.schema.json
@@ -41,6 +41,45 @@
        "maxBytes": {"type": "integer", "exclusiveMinimum": 0}
      }
    },
-    "route": {"type": "object", "additionalProperties": false, "required": ["method", "path", "type", "render"], "properties": {"method": {"enum": ["GET", "POST", "PUT", "PATCH", "DELETE"]}, "path": {"type": "string", "pattern": "^/"}, "type": {"enum": ["submit", "query", "dynamic"]}, "action": {"type": "string"}, "taskIdParam": {"type": "string"}, "decode": {"type": "string"}, "render": {"type": "string"}, "models": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "string", "minLength": 1}}}, "allOf": [{"if": {"properties": {"type": {"const": "query"}}}, "then": {"allOf": [{"not": {"required": ["decode"]}}, {"not": {"required": ["models"]}}]}}, {"if": {"properties": {"type": {"enum": ["submit", "dynamic"]}}}, "then": {"required": ["decode"]}}]}
+    "route": {"type": "object", "additionalProperties": false, "required": ["method", "path", "type", "render"], "properties": {"method": {"enum": ["GET", "POST", "PUT", "PATCH", "DELETE"]}, "path": {"type": "string", "pattern": "^/"}, "type": {"enum": ["submit", "query", "dynamic"]}, "action": {"type": "string"}, "taskIdParam": {"type": "string"}, "decode": {"type": "string"}, "render": {"type": "string"}, "models": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "string", "minLength": 1}}}, "allOf": [{"if": {"properties": {"type": {"const": "query"}}}, "then": {"allOf": [{"not": {"required": ["decode"]}}, {"not": {"required": ["models"]}}]}}, {"if": {"properties": {"type": {"enum": ["submit", "dynamic"]}}}, "then": {"required": ["decode"]}}]},
+    "taskQueryContext": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["taskId", "publicTaskId", "action", "model", "upstreamModel", "baseUrl", "authHeader", "data", "state"],
+      "properties": {
+        "taskId": {"type": "string"},
+        "publicTaskId": {"type": "string"},
+        "action": {"type": "string"},
+        "model": {"type": "string"},
+        "upstreamModel": {"type": "string"},
+        "baseUrl": {"type": "string"},
+        "apiKey": {"type": "string"},
+        "authHeader": {"type": "string"},
+        "auth": true,
+        "data": true,
+        "state": true
+      }
+    },
+    "batchQueryContext": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["baseUrl", "authHeader", "tasks"],
+      "properties": {
+        "baseUrl": {"type": "string"},
+        "apiKey": {"type": "string"},
+        "authHeader": {"type": "string"},
+        "auth": true,
+        "tasks": {"type": "array", "items": {"$ref": "#/$defs/taskQueryContext"}}
+      }
+    },
+    "hookHTTPResponse": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "headers"],
+      "properties": {
+        "status": {"type": "integer"},
+        "headers": {"type": "object", "additionalProperties": {"type": "string"}}
+      }
+    }
  }
 }
--- a/model/log_other.go
+++ b/model/log_other.go
@@ -140,9 +140,7 @@ func (o *LogOther) toMap() map[string]any {
 		return result
 	}
-	for key, value := range o.public {
+	maps.Copy(result, o.public)
-		result[key] = value
-	}
 	if adminInfo := copyLogOtherMap(o.adminInfo); len(adminInfo) > 0 {
 		result[logOtherAdminInfoKey] = adminInfo
 	}

--- a/model/task.go
+++ b/model/task.go
@@ -126,6 +126,11 @@ type TaskPrivateData struct {
 	// disconnect regardless; this only echoes the protocol-level request
 	// attribute back on retrieval snapshots.
 	ResponsesBackground bool `json:"responses_background,omitempty"`
+	// PluginState is plugin-owned cross-round data. Unlike Task.Data it is
+	// only replaced when a hook explicitly returns state.
+	PluginState json.RawMessage `json:"plugin_state,omitempty"`
+	// PollFailures counts consecutive unrecognized or transient poll outcomes.
+	PollFailures int `json:"poll_failures,omitempty"`
 }
 type TaskExecutionSnapshot struct {
@@ -194,7 +199,10 @@ func (p *TaskPrivateData) Scan(val interface{}) error {
 }
 func (p TaskPrivateData) Value() (driver.Value, error) {
-	if (p == TaskPrivateData{}) {
+	if p.Key == "" && p.UpstreamTaskID == "" && p.ResultURL == "" &&
+		p.Execution == nil && p.BillingSource == "" && p.SubscriptionId == 0 &&
+		p.TokenId == 0 && p.NodeName == "" && p.BillingContext == nil &&
+		!p.ResponsesBackground && len(p.PluginState) == 0 && p.PollFailures == 0 {
 		return nil, nil
 	}
 	// 同 Properties.Value:string 避免 PG simple protocol 的 bytea 编码。
@@ -466,13 +474,15 @@ func (Task *Task) InsertWithContext(ctx context.Context) error {
 }
 type taskSnapshot struct {
-	Status     TaskStatus
+	Status       TaskStatus
-	Progress   string
+	Progress     string
-	StartTime  int64
+	StartTime    int64
-	FinishTime int64
+	FinishTime   int64
-	FailReason string
+	FailReason   string
-	ResultURL  string
+	ResultURL    string
-	Data       json.RawMessage
+	Data         json.RawMessage
+	PluginState  json.RawMessage
+	PollFailures int
 }
 func (s taskSnapshot) Equal(other taskSnapshot) bool {
@@ -482,18 +492,22 @@ func (s taskSnapshot) Equal(other taskSnapshot) bool {
 		s.FinishTime == other.FinishTime &&
 		s.FailReason == other.FailReason &&
 		s.ResultURL == other.ResultURL &&
-		bytes.Equal(s.Data, other.Data)
+		bytes.Equal(s.Data, other.Data) &&
+		bytes.Equal(s.PluginState, other.PluginState) &&
+		s.PollFailures == other.PollFailures
 }
 func (t *Task) Snapshot() taskSnapshot {
 	return taskSnapshot{
-		Status:     t.Status,
+		Status:       t.Status,
-		Progress:   t.Progress,
+		Progress:     t.Progress,
-		StartTime:  t.StartTime,
+		StartTime:    t.StartTime,
-		FinishTime: t.FinishTime,
+		FinishTime:   t.FinishTime,
-		FailReason: t.FailReason,
+		FailReason:   t.FailReason,
-		ResultURL:  t.PrivateData.ResultURL,
+		ResultURL:    t.PrivateData.ResultURL,
-		Data:       t.Data,
+		Data:         t.Data,
+		PluginState:  t.PrivateData.PluginState,
+		PollFailures: t.PrivateData.PollFailures,
 	}
 }

--- a/model/task_cas_test.go
+++ b/model/task_cas_test.go
@@ -177,6 +177,29 @@ func TestSnapshotEqual_NilVsEmpty(t *testing.T) {
 	assert.True(t, a.Equal(b))
 }
+func TestSnapshotEqual_PluginStateAndPollFailures(t *testing.T) {
+	base := taskSnapshot{
+		Status:       TaskStatusInProgress,
+		PluginState:  json.RawMessage(`{"req_key":"a"}`),
+		PollFailures: 2,
+	}
+	assert.True(t, base.Equal(taskSnapshot{
+		Status:       TaskStatusInProgress,
+		PluginState:  json.RawMessage(`{"req_key":"a"}`),
+		PollFailures: 2,
+	}))
+	assert.False(t, base.Equal(taskSnapshot{
+		Status:       TaskStatusInProgress,
+		PluginState:  json.RawMessage(`{"req_key":"b"}`),
+		PollFailures: 2,
+	}))
+	assert.False(t, base.Equal(taskSnapshot{
+		Status:       TaskStatusInProgress,
+		PluginState:  json.RawMessage(`{"req_key":"a"}`),
+		PollFailures: 3,
+	}))
+}
 func TestSnapshot_Roundtrip(t *testing.T) {
 	task := &Task{
 		Status:     TaskStatusInProgress,
@@ -185,7 +208,9 @@ func TestSnapshot_Roundtrip(t *testing.T) {
 		FinishTime: 5678,
 		FailReason: "timeout",
 		PrivateData: TaskPrivateData{
-			ResultURL: "https://example.com/result.mp4",
+			ResultURL:    "https://example.com/result.mp4",
+			PluginState:  json.RawMessage(`{"req_key":"keep"}`),
+			PollFailures: 3,
 		},
 		Data: json.RawMessage(`{"model":"test-model"}`),
 	}
@@ -197,6 +222,8 @@ func TestSnapshot_Roundtrip(t *testing.T) {
 	assert.Equal(t, task.FailReason, snap.FailReason)
 	assert.Equal(t, task.PrivateData.ResultURL, snap.ResultURL)
 	assert.JSONEq(t, string(task.Data), string(snap.Data))
+	assert.Equal(t, task.PrivateData.PluginState, snap.PluginState)
+	assert.Equal(t, task.PrivateData.PollFailures, snap.PollFailures)
 }
 // ---------------------------------------------------------------------------
@@ -292,3 +319,30 @@ func TestUpdateWithStatus_ConcurrentWinner(t *testing.T) {
 	}
 	assert.Equal(t, 1, winCount, "exactly one goroutine should win the CAS")
 }
+func TestUpdateWithStatus_PersistsPluginStateAndPollFailures(t *testing.T) {
+	truncateTables(t)
+	task := &Task{
+		TaskID: "task_cas_plugin_state",
+		Status: TaskStatusInProgress,
+		Data:   json.RawMessage(`{}`),
+		PrivateData: TaskPrivateData{
+			PluginState:  json.RawMessage(`{"req_key":"old"}`),
+			PollFailures: 1,
+		},
+	}
+	insertTask(t, task)
+	task.PrivateData.PluginState = json.RawMessage(`{"req_key":"new"}`)
+	task.PrivateData.PollFailures = 4
+	won, err := task.UpdateWithStatus(TaskStatusInProgress)
+	require.NoError(t, err)
+	require.True(t, won)
+	var reloaded Task
+	require.NoError(t, DB.First(&reloaded, task.ID).Error)
+	assert.EqualValues(t, TaskStatusInProgress, reloaded.Status)
+	assert.JSONEq(t, `{"req_key":"new"}`, string(reloaded.PrivateData.PluginState))
+	assert.Equal(t, 4, reloaded.PrivateData.PollFailures)
+}
--- a/pkg/jsplugin/cli.go
+++ b/pkg/jsplugin/cli.go
@@ -33,6 +33,7 @@ func RunCLI(args []string, stdout, stderr io.Writer) int {
 			fmt.Fprintf(stderr, "plugin lint failed: %v\n", compileErr)
 			return 1
 		}
+		warnParseTaskResultInProgressFallback(string(source), stderr)
 		fmt.Fprintf(stdout, "plugin %s@%s is valid\n", plugin.Meta.Key, plugin.Meta.Version)
 		return 0
 	case "test":
@@ -57,3 +58,35 @@ func RunCLI(args []string, stdout, stderr io.Writer) int {
 		return 2
 	}
 }
+func warnParseTaskResultInProgressFallback(source string, stderr io.Writer) {
+	body := parseTaskResultFunctionBody(source)
+	if strings.Contains(body, `|| "IN_PROGRESS"`) || strings.Contains(body, `|| 'IN_PROGRESS'`) {
+		fmt.Fprintln(stderr, `warning: parseTaskResult uses || "IN_PROGRESS" fallback; return UNKNOWN for unrecognized statuses`)
+	}
+}
+func parseTaskResultFunctionBody(source string) string {
+	marker := strings.Index(source, "function parseTaskResult")
+	if marker < 0 {
+		return ""
+	}
+	brace := strings.Index(source[marker:], "{")
+	if brace < 0 {
+		return ""
+	}
+	start := marker + brace
+	depth := 0
+	for i := start; i < len(source); i++ {
+		switch source[i] {
+		case '{':
+			depth++
+		case '}':
+			depth--
+			if depth == 0 {
+				return source[start : i+1]
+			}
+		}
+	}
+	return ""
+}
--- a/pkg/jsplugin/cli_test.go
+++ b/pkg/jsplugin/cli_test.go
@@ -28,6 +28,25 @@ func TestPluginCLI(t *testing.T) {
 	assert.Contains(t, stdout.String(), "1/1 cases")
 }
+func TestPluginCLIWarnsOnParseTaskResultInProgressFallback(t *testing.T) {
+	tempDir := t.TempDir()
+	pluginPath := filepath.Join(tempDir, "fallback.js")
+	require.NoError(t, os.WriteFile(pluginPath, []byte(`
+export const meta = { apiVersion: 1, key: "fallback", name: "Fallback", version: "1.0.0", author: {name: "Test"}, models: ["m"], fetchMode: "per_task" };
+export function buildSubmitRequest(ctx) { return {url: ctx.baseUrl}; }
+export function parseSubmitResponse() { return {taskId: "task"}; }
+export function buildQueryRequest(ctx) { return {url: ctx.baseUrl}; }
+export function parseTaskResult(ctx, body) { return {status: statuses[body.status] || "IN_PROGRESS"}; }
+const statuses = { done: "SUCCESS" };
+`), 0o600))
+	var stdout bytes.Buffer
+	var stderr bytes.Buffer
+	assert.Equal(t, 0, RunCLI([]string{"lint", pluginPath}, &stdout, &stderr))
+	assert.Contains(t, stdout.String(), "plugin fallback@1.0.0 is valid")
+	assert.Contains(t, stderr.String(), `|| "IN_PROGRESS"`)
+}
 const cliFixturePluginSource = `
 export const meta = { apiVersion: 1, key: "cli-fixture", name: "CLI Fixture", version: "1.0.0", author: {name: "Test"}, channelTypes: [1003], models: ["fixture-model"], fetchMode: "per_task" };
 export function buildSubmitRequest(ctx) { return {url: ctx.baseUrl}; }

--- a/plugins/hailuo_responses_test.go
+++ b/plugins/hailuo_responses_test.go
@@ -346,6 +346,9 @@ func TestHailuoParseTaskResult(t *testing.T) {
 		{"H3 permanent query error", `{"type":"error","error":{"type":"authorized_error","message":"login failed","http_code":"401"}}`, "FAILURE", "", "login failed"},
 		{"legacy success", `{"task_id":"1","status":"Success","file_id":"f1","base_resp":{"status_code":0}}`, "SUCCESS", "", ""},
 		{"legacy processing", `{"task_id":"1","status":"Processing","base_resp":{"status_code":0}}`, "IN_PROGRESS", "", ""},
+		{"H3 unrecognized", `{"task":{"id":"1","status":"weird"}}`, "UNKNOWN", "", "unrecognized status: weird"},
+		{"legacy unrecognized", `{"task_id":"1","status":"Weird","base_resp":{"status_code":0}}`, "UNKNOWN", "", "unrecognized status: Weird"},
+		{"legacy base_resp failure", `{"task_id":"1","status":"Success","base_resp":{"status_code":1001,"status_msg":"upstream down"}}`, "FAILURE", "", "upstream down"},
 	}
 	for _, testCase := range testCases {
 		t.Run(testCase.name, func(t *testing.T) {
@@ -451,7 +454,7 @@ func TestHailuoH3CompletionUsageFacts(t *testing.T) {
 	t.Run("polling adaptor carries actual facts into task settlement", func(t *testing.T) {
 		adaptor := taskplugin.New(plugin)
-		result, err := adaptor.ParseTaskResult([]byte(
+		result, err := adaptor.ParseTaskResult(&model.Task{}, &http.Response{StatusCode: http.StatusOK, Header: make(http.Header)}, []byte(
 			`{"task":{"id":"1","status":"succeeded","resolution":"2K","usage":{"output_seconds":5,"input_seconds":7.5,"input_image_count":6}}}`,
 		))
 		require.NoError(t, err)

--- a/plugins/jimeng_responses_test.go
+++ b/plugins/jimeng_responses_test.go
 package plugins_test
-import "testing"
+import (
+	"testing"
+	"github.com/QuantumNous/new-api/common"
+	"github.com/QuantumNous/new-api/pkg/jsplugin"
+	builtinplugins "github.com/QuantumNous/new-api/plugins"
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
 func TestJimengResponsesProtocol(t *testing.T) {
 	testVideoResponsesProtocol(t, videoResponsesTestCase{
@@ -25,3 +33,60 @@ func TestJimengResponsesProtocol(t *testing.T) {
 		wantVendorName: "jimeng",
 	})
 }
+func loadJimengPlugin(t *testing.T) *jsplugin.LoadedPlugin {
+	t.Helper()
+	source, err := builtinplugins.Source("jimeng")
+	require.NoError(t, err)
+	plugin, err := jsplugin.NewRegistry().RegisterFactory(source, jsplugin.Options{Key: "jimeng"})
+	require.NoError(t, err)
+	return plugin
+}
+func TestJimengSubmitStateDrivesQueryReqKey(t *testing.T) {
+	plugin := loadJimengPlugin(t)
+	submitValue, err := plugin.Engine.Call(t.Context(), "parseSubmitResponse", map[string]any{
+		"upstreamModel": "jimeng_vgfm_i2v_l20",
+		"requestBody":   map[string]any{"images": []any{"https://cdn.example/frame.png"}},
+	}, map[string]any{"body": map[string]any{"code": 10000, "data": map[string]any{"task_id": "t1"}}})
+	require.NoError(t, err)
+	encoded, err := common.Marshal(submitValue)
+	require.NoError(t, err)
+	var submit map[string]any
+	require.NoError(t, common.Unmarshal(encoded, &submit))
+	state, ok := submit["state"].(map[string]any)
+	require.True(t, ok)
+	assert.Equal(t, "jimeng_vgfm_i2v_l20", state["req_key"])
+	queryValue, err := plugin.Engine.Call(t.Context(), "buildQueryRequest", map[string]any{
+		"taskId":  "t1",
+		"action":  "text_to_video",
+		"baseUrl": "https://jimeng.example",
+		"apiKey":  "sk-test",
+		"state":   map[string]any{"req_key": "custom_req_key"},
+	})
+	require.NoError(t, err)
+	queryEncoded, err := common.Marshal(queryValue)
+	require.NoError(t, err)
+	var query map[string]any
+	require.NoError(t, common.Unmarshal(queryEncoded, &query))
+	var body map[string]any
+	require.NoError(t, common.UnmarshalJsonStr(common.Interface2String(query["body"]), &body))
+	assert.Equal(t, "custom_req_key", body["req_key"])
+	assert.Equal(t, "t1", body["task_id"])
+}
+func TestJimengParseTaskResultUnknownStatus(t *testing.T) {
+	plugin := loadJimengPlugin(t)
+	value, err := plugin.Engine.Call(t.Context(), "parseTaskResult", map[string]any{}, map[string]any{
+		"code": 10000,
+		"data": map[string]any{"status": "weird"},
+	})
+	require.NoError(t, err)
+	encoded, err := common.Marshal(value)
+	require.NoError(t, err)
+	var result map[string]any
+	require.NoError(t, common.Unmarshal(encoded, &result))
+	assert.Equal(t, "UNKNOWN", result["status"])
+	assert.Contains(t, common.Interface2String(result["reason"]), "weird")
+}
--- a/plugins/tasks/alibaba/plugin.js
+++ b/plugins/tasks/alibaba/plugin.js
@@ -7,7 +7,7 @@ export const meta = {
    en: "Alibaba Cloud Bailian Wanxiang video generation (text-to-video and image-to-video)",
    zh: "阿里云百炼万相视频生成（文生视频、图生视频）",
  },
-  version: "1.0.0",
+  version: "1.0.1",
  author: { name: "QuantumNous" },
  channelTypes: [17],
  models: [
@@ -270,7 +270,7 @@ export function parseTaskResult(ctx, body) {
    if (!reason) reason = "task failed";
    return { status: "FAILURE", reason: reason };
  }
-  return { status: "QUEUED" };
+  return { status: "UNKNOWN", reason: "unrecognized status: " + String(output.task_status || "") };
 }
 function artifactData(ctx) {

--- a/plugins/tasks/doubao/plugin.js
+++ b/plugins/tasks/doubao/plugin.js
@@ -7,7 +7,7 @@ export const meta = {
    en: "Volcengine Doubao Seedance video generation (text-to-video, image-to-video, and video-to-video)",
    zh: "火山引擎豆包 Seedance 视频生成（文生视频、图生视频、视频生视频）",
  },
-  version: "1.0.0",
+  version: "1.0.1",
  author: { name: "QuantumNous" },
  channelTypes: [54, 45], // VolcEngine-type channels serve Ark video models with the same wire format
  models: [
@@ -324,7 +324,7 @@ export function parseTaskResult(ctx, body) {
    const reason = body.error && body.error.message ? body.error.message : body.status;
    return { status: "FAILURE", progress: "100%", reason: reason };
  }
-  return { status: "IN_PROGRESS", progress: "30%" };
+  return { status: "UNKNOWN", reason: "unrecognized status: " + String(body.status || "") };
 }
 function artifactData(ctx) {

--- a/plugins/tasks/google/plugin.js
+++ b/plugins/tasks/google/plugin.js
@@ -7,7 +7,7 @@ export const meta = {
    en: "Google Veo video generation on the Gemini API (text-to-video and image-to-video)",
    zh: "Google Veo 视频生成（文生视频、图生视频），Gemini API 版本",
  },
-  version: "1.0.0",
+  version: "1.0.1",
  author: { name: "QuantumNous" },
  channelTypes: [24],
  models: ["veo-3.0-generate-001", "veo-3.0-fast-generate-001", "veo-3.1-generate-preview", "veo-3.1-fast-generate-preview"],
@@ -209,7 +209,11 @@ export function buildQueryRequest(ctx) {
 export function parseTaskResult(ctx, body) {
  if (body.error && body.error.message) return { status: "FAILURE", progress: "100%", reason: body.error.message };
-  if (!body.done) return { status: "IN_PROGRESS", progress: "50%" };
+  // Google long-running operations omit `done` (proto3 default) while still
+  // running, so a missing key means in-progress; only a non-operation shape is
+  // unrecognized.
+  if (!body || typeof body !== "object" || !String(body.name || "").trim()) return { status: "UNKNOWN", reason: "unrecognized operation state" };
+  if (body.done !== true) return { status: "IN_PROGRESS", progress: "50%" };
  const videos = ((body.response || {}).generateVideoResponse || {}).generatedVideos || [];
  const uri = videos.length && videos[0].video ? videos[0].video.uri || "" : "";
  return { taskId: utils.base64URL(body.name || ""), status: "SUCCESS", progress: "100%", remoteUrl: uri };

--- a/plugins/tasks/hailuo/plugin.js
+++ b/plugins/tasks/hailuo/plugin.js
@@ -7,7 +7,7 @@ export const meta = {
    en: "MiniMax Hailuo video generation (text-to-video, image-to-video, and MiniMax-H3 multimodal reference)",
    zh: "MiniMax 海螺视频生成（文生视频、图生视频、MiniMax-H3 多模态参考生视频）",
  },
-  version: "1.1.1",
+  version: "1.1.2",
  author: { name: "QuantumNous" },
  channelTypes: [35],
  models: [
@@ -465,8 +465,6 @@ export function buildQueryRequest(ctx) {
 }
 export function parseTaskResult(ctx, body) {
-  // The host calls this hook with an empty context, so the response envelope is
-  // the only way to tell a /v2 result from a /v1 one.
  const apiError = h3APIError(body);
  if (apiError) {
    if (apiError.statusCode === 408 || apiError.statusCode === 429 || apiError.statusCode >= 500) throw new Error(apiError.message);
@@ -475,7 +473,10 @@ export function parseTaskResult(ctx, body) {
  const h3Task = h3QueryTask(body);
  if (h3Task) {
    const h3Statuses = { queued: "QUEUED", running: "IN_PROGRESS", succeeded: "SUCCESS", failed: "FAILURE", cancelled: "FAILURE" };
-    const h3Status = h3Statuses[h3Task.status] || "IN_PROGRESS";
+    const h3Status = h3Statuses[h3Task.status];
+    if (!h3Status) {
+      return { status: "UNKNOWN", reason: "unrecognized status: " + String(h3Task.status || "") };
+    }
    const h3Result = { code: 0, status: h3Status, progress: h3Status === "QUEUED" ? "30%" : h3Status === "IN_PROGRESS" ? "50%" : "100%" };
    if (h3Status === "SUCCESS") {
      const url = trimmed(h3Task.content && h3Task.content.url);
@@ -486,11 +487,17 @@ export function parseTaskResult(ctx, body) {
    }
    return h3Result;
  }
+  if (body.base_resp && body.base_resp.status_code !== 0) {
+    return { code: body.base_resp.status_code || 0, status: "FAILURE", progress: "100%", reason: body.base_resp.status_msg || "" };
+  }
  const base = body.base_resp || {};
  const statuses = { Preparing: "IN_PROGRESS", Queueing: "IN_PROGRESS", Processing: "IN_PROGRESS", Success: "SUCCESS", Fail: "FAILURE" };
-  const status = statuses[body.status] || "IN_PROGRESS";
+  const status = statuses[body.status];
+  if (!status) {
+    return { status: "UNKNOWN", reason: "unrecognized status: " + String(body.status || "") };
+  }
  const progress = status === "SUCCESS" || status === "FAILURE" ? "100%" : body.status === "Processing" ? "50%" : "30%";
-  const reason = base.status_code !== 0 ? base.status_msg || "" : status === "FAILURE" ? "task failed" : "";
+  const reason = status === "FAILURE" ? "task failed" : "";
  return { code: base.status_code || 0, status: status, progress: progress, reason: reason };
 }

--- a/plugins/tasks/jimeng/plugin.js
+++ b/plugins/tasks/jimeng/plugin.js
@@ -7,7 +7,7 @@ export const meta = {
    en: "Volcengine Jimeng video generation (text-to-video, image-to-video, and first-and-last-frame)",
    zh: "火山引擎即梦视频生成（文生视频、图生视频、首尾帧）",
  },
-  version: "1.0.0",
+  version: "1.0.1",
  author: { name: "QuantumNous" },
  channelTypes: [51],
  models: ["jimeng_vgfm_t2v_l20"],
@@ -270,10 +270,8 @@ function filePlaceholder(image) {
 }
 function queryReqKey(ctx) {
-  const data = (ctx && ctx.data) || {};
+  const state = (ctx && ctx.state) || {};
-  if (typeof data.req_key === "string" && data.req_key.trim()) return data.req_key.trim();
+  if (typeof state.req_key === "string" && state.req_key.trim()) return state.req_key.trim();
-  const req = (ctx && ctx.requestBody) || {};
-  if (typeof req.req_key === "string" && req.req_key.trim()) return req.req_key.trim();
  if (ctx && ctx.action === "image_to_video") return "jimeng_vgfm_i2v_l20";
  if (ctx && ctx.action === "first_tail_to_video") return "jimeng_i2v_first_tail_v30";
  return "jimeng_vgfm_t2v_l20";
@@ -349,7 +347,7 @@ export function parseSubmitResponse(ctx, resp) {
  const body = resp.body || {};
  if (body.code !== 10000) throw new Error(body.message || "jimeng submit failed");
  if (!body.data || !body.data.task_id) throw new Error("missing task_id");
-  return { taskId: body.data.task_id, taskData: Object.assign({}, body, { req_key: submitReqKey(ctx) }) };
+  return { taskId: body.data.task_id, taskData: Object.assign({}, body, { req_key: submitReqKey(ctx) }), state: { req_key: submitReqKey(ctx) } };
 }
 export function extractUsage(ctx) {
@@ -366,22 +364,20 @@ export function buildQueryRequest(ctx) {
 export function parseTaskResult(ctx, body) {
  const data = body.data || {};
-  let status = "";
-  let progress = "";
  if (body.code !== 10000) {
-    status = "FAILURE";
+    return { code: body.code || 0, status: "FAILURE", progress: "100%", reason: body.message || "" };
-    progress = "100%";
  }
  if (data.status === "in_queue") {
-    status = "QUEUED";
+    const result = { code: 0, status: "QUEUED", progress: "10%", reason: "" };
-    progress = "10%";
+    if (data.video_url) result.url = data.video_url;
-  } else if (data.status === "done") {
+    return result;
-    status = "SUCCESS";
+  }
-    progress = "100%";
+  if (data.status === "done") {
+    const result = { code: 0, status: "SUCCESS", progress: "100%", reason: "" };
+    if (data.video_url) result.url = data.video_url;
+    return result;
  }
-  const result = { code: body.code === 10000 ? 0 : body.code || 0, status: status, progress: progress, reason: body.code === 10000 ? "" : body.message || "" };
+  return { code: 0, status: "UNKNOWN", reason: "unrecognized status: " + String(data.status || "") };
-  if (data.video_url) result.url = data.video_url;
-  return result;
 }
 function artifactData(ctx) {

--- a/plugins/tasks/kling/plugin.js
+++ b/plugins/tasks/kling/plugin.js
@@ -7,7 +7,7 @@ export const meta = {
    en: "Kuaishou Kling video generation (text-to-video and image-to-video)",
    zh: "快手可灵视频生成（文生视频、图生视频）",
  },
-  version: "1.0.0",
+  version: "1.0.1",
  author: { name: "QuantumNous" },
  channelTypes: [50],
  models: ["kling-v1", "kling-v1-6", "kling-v2-master"],
@@ -286,7 +286,7 @@ export function parseTaskResult(ctx, body) {
  const data = body.data || {};
  const statuses = { submitted: "SUBMITTED", processing: "IN_PROGRESS", succeed: "SUCCESS", failed: "FAILURE" };
  const status = statuses[data.task_status];
-  if (!status) throw new Error("unknown task status: " + data.task_status);
+  if (!status) return { status: "UNKNOWN", reason: "unknown task status: " + String(data.task_status || "") };
  const videos = status === "SUCCESS" && data.task_result && data.task_result.videos ? data.task_result.videos : [];
  const result = { code: body.code || 0, taskId: data.task_id, status: status, reason: data.task_status_msg || "" };
  if (videos.length && videos[0].url) result.url = videos[0].url;

--- a/plugins/tasks/sora/plugin.js
+++ b/plugins/tasks/sora/plugin.js
@@ -7,7 +7,7 @@ export const meta = {
    en: "OpenAI Sora video generation (text-to-video, image-to-video, and remix)",
    zh: "OpenAI Sora 视频生成（文生视频、图生视频、remix）",
  },
-  version: "1.0.0",
+  version: "1.0.1",
  channelTypes: [55, 1], // OpenAI-type channels natively serve sora with the same wire format
  author: { name: "QuantumNous" },
  models: ["sora-2", "sora-2-pro"],
@@ -145,7 +145,9 @@ export function parseTaskResult(ctx, body) {
    failed: "FAILURE",
    cancelled: "FAILURE",
  };
-  const result = { status: statuses[body.status] || "UNKNOWN" };
+  const mapped = statuses[body.status];
+  const result = { status: mapped || "UNKNOWN" };
+  if (!mapped) result.reason = "unrecognized status: " + String(body.status || "");
  if (body.progress > 0 && body.progress < 100) result.progress = body.progress + "%";
  if (result.status === "FAILURE") result.reason = body.error && body.error.message ? body.error.message : "task failed";
  return result;

--- a/plugins/tasks/sunoapi/plugin.js
+++ b/plugins/tasks/sunoapi/plugin.js
@@ -9,7 +9,7 @@ export const meta = {
    en: "SunoAPI project music and lyrics generation",
    zh: "SunoAPI 项目 音乐与歌词生成",
  },
-  version: "1.0.0",
+  version: "1.0.1",
  author: { name: "QuantumNous" },
  channelTypes: [36],
  models: ["suno_music", "suno_lyrics"],
@@ -133,19 +133,23 @@ export function extractUsage(ctx) {
  return { clips: action === "lyrics" ? 1 : 2, action: action };
 }
-export function buildBatchQueryRequest(ctx, taskIds) {
+export function buildBatchQueryRequest(ctx, tasks) {
  return {
    url: ctx.baseUrl + "/suno/fetch",
    method: "POST",
    headers: { "Content-Type": "application/json", Authorization: "Bearer " + ctx.apiKey },
-    body: { ids: taskIds },
+    body: {
+      ids: (tasks || []).map(function (task) {
+        return task.taskId;
+      }),
+    },
  };
 }
 // Required v1 per-task hooks remain defined for contract compatibility. Suno's
 // host polling path uses the batch hooks below.
 export function buildQueryRequest(ctx) {
-  return buildBatchQueryRequest(ctx, (ctx.requestBody || {}).ids || []);
+  return buildBatchQueryRequest(ctx, [ctx]);
 }
 export function parseBatchResult(ctx, body) {

--- a/plugins/tasks/vertex-ai/plugin.js
+++ b/plugins/tasks/vertex-ai/plugin.js
@@ -7,7 +7,7 @@ export const meta = {
    en: "Google Veo video generation on Vertex AI (text-to-video and image-to-video)",
    zh: "Google Veo 视频生成（文生视频、图生视频），Vertex AI 版本",
  },
-  version: "1.0.0",
+  version: "1.0.1",
  channelTypes: [41],
  author: { name: "QuantumNous" },
  models: ["veo-3.0-generate-001", "veo-3.0-fast-generate-001", "veo-3.1-generate-preview", "veo-3.1-fast-generate-preview"],
@@ -225,7 +225,11 @@ export function buildQueryRequest(ctx) {
 }
 export function parseTaskResult(ctx, body) {
  if (body.error && body.error.message) return { status: "FAILURE", progress: "100%", reason: body.error.message };
-  if (!body.done) return { status: "IN_PROGRESS", progress: "50%" };
+  // Google long-running operations omit `done` (proto3 default) while still
+  // running, so a missing key means in-progress; only a non-operation shape is
+  // unrecognized.
+  if (!body || typeof body !== "object" || !String(body.name || "").trim()) return { status: "UNKNOWN", reason: "unrecognized operation state" };
+  if (body.done !== true) return { status: "IN_PROGRESS", progress: "50%" };
  const url = dataVideo(body.response || {});
  return { status: "SUCCESS", progress: "100%", url: url, remoteUrl: url };
 }

--- a/plugins/tasks/vidu/plugin.js
+++ b/plugins/tasks/vidu/plugin.js
@@ -7,7 +7,7 @@ export const meta = {
    en: "Shengshu Vidu video generation (text-to-video, image-to-video, first-and-last-frame, and reference-to-video)",
    zh: "生数 Vidu 视频生成（文生视频、图生视频、首尾帧、参考生视频）",
  },
-  version: "1.0.0",
+  version: "1.0.1",
  author: { name: "QuantumNous" },
  channelTypes: [52],
  models: ["viduq2", "viduq1", "vidu2.0", "vidu1.5"],
@@ -265,7 +265,7 @@ export function buildQueryRequest(ctx) {
 export function parseTaskResult(ctx, body) {
  const statuses = { created: "SUBMITTED", queueing: "SUBMITTED", processing: "IN_PROGRESS", success: "SUCCESS", failed: "FAILURE" };
  const status = statuses[body.state];
-  if (!status) throw new Error("unknown task state: " + body.state);
+  if (!status) return { status: "UNKNOWN", reason: "unknown task state: " + String(body.state || "") };
  const url = body.creations && body.creations.length ? body.creations[0].url || "" : "";
  const result = { status: status, reason: body.state === "failed" ? body.err_code || "" : "" };
  if (url) result.url = url;

--- a/plugins/veo_poll_test.go
+++ b/plugins/veo_poll_test.go
+package plugins_test
+import (
+	"testing"
+	"github.com/QuantumNous/new-api/common"
+	"github.com/QuantumNous/new-api/pkg/jsplugin"
+	builtinplugins "github.com/QuantumNous/new-api/plugins"
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+// Google long-running operations serialize proto3 defaults by omission: a
+// still-running operation has no `done` key at all. Treating that as
+// unrecognized would count every normal poll as a failure and fail the task
+// at the poll-failure threshold while the video is still rendering.
+func TestVeoParseTaskResultTreatsMissingDoneAsInProgress(t *testing.T) {
+	cases := []struct {
+		name       string
+		body       map[string]any
+		wantStatus string
+	}{
+		{
+			name:       "running operation omits done",
+			body:       map[string]any{"name": "operations/abc", "metadata": map[string]any{"@type": "x"}},
+			wantStatus: "IN_PROGRESS",
+		},
+		{
+			name:       "explicit done false",
+			body:       map[string]any{"name": "operations/abc", "done": false},
+			wantStatus: "IN_PROGRESS",
+		},
+		{
+			name:       "body without operation name is unrecognized",
+			body:       map[string]any{"foo": "bar"},
+			wantStatus: "UNKNOWN",
+		},
+		{
+			name:       "operation error is failure",
+			body:       map[string]any{"name": "operations/abc", "done": true, "error": map[string]any{"message": "quota exceeded"}},
+			wantStatus: "FAILURE",
+		},
+	}
+	for _, key := range []string{"google", "vertex-ai"} {
+		source, err := builtinplugins.Source(key)
+		require.NoError(t, err)
+		plugin, err := jsplugin.NewRegistry().RegisterFactory(source, jsplugin.Options{Key: key})
+		require.NoError(t, err)
+		for _, tc := range cases {
+			t.Run(key+"/"+tc.name, func(t *testing.T) {
+				value, err := plugin.Engine.Call(t.Context(), "parseTaskResult", map[string]any{}, tc.body)
+				require.NoError(t, err)
+				encoded, err := common.Marshal(value)
+				require.NoError(t, err)
+				var result map[string]any
+				require.NoError(t, common.Unmarshal(encoded, &result))
+				assert.Equal(t, tc.wantStatus, result["status"])
+			})
+		}
+	}
+}
--- a/relay/channel/adapter.go
+++ b/relay/channel/adapter.go
@@ -76,8 +76,8 @@ type TaskAdaptor interface {
 	// ── Polling ──────────────────────────────────────────────────────
-	FetchTask(baseUrl, key string, body map[string]any, proxy string) (*http.Response, error)
+	FetchTask(baseUrl, key string, task *model.Task, proxy string) (*http.Response, error)
-	ParseTaskResult(respBody []byte) (*relaycommon.TaskInfo, error)
+	ParseTaskResult(task *model.Task, resp *http.Response, respBody []byte) (*relaycommon.TaskInfo, error)
 }
 // TaskSubmitResponse is the transport-independent result of parsing an
@@ -87,6 +87,7 @@ type TaskSubmitResponse struct {
 	TaskData       []byte
 	ClientResponse any
 	Immediate      *relaycommon.TaskInfo
+	PluginState    []byte
 }
 type OpenAIVideoConverter interface {

--- a/relay/channel/task/jsplugin/adaptor.go
+++ b/relay/channel/task/jsplugin/adaptor.go
--- a/relay/channel/task/jsplugin/adaptor_test.go
+++ b/relay/channel/task/jsplugin/adaptor_test.go
--- a/relay/common/relay_info.go
+++ b/relay/common/relay_info.go
@@ -119,19 +119,19 @@ type RelayInfo struct {
 	ReasoningEffort    string
 	// ReasoningConversion is the suffix-derived reasoning intent attached
 	// after model mapping. Converters read it via ReasoningState().
-	ReasoningConversion   *dto.ReasoningConversionState
+	ReasoningConversion *dto.ReasoningConversionState
-	UserSetting           dto.UserSetting
+	UserSetting         dto.UserSetting
-	UserEmail             string
+	UserEmail           string
-	UserQuota             int
+	UserQuota           int
-	RelayFormat       types.RelayFormat
+	RelayFormat         types.RelayFormat
-	SendResponseCount int
+	SendResponseCount   int
 	// ClaudeToChatStreamState / ChatToGeminiStreamState hold per-attempt
 	// stream converters. InitChannelMeta nils them so a retry cannot resume a
 	// dirty converter (advanced tool index / finalized).
 	ClaudeToChatStreamState any
 	ChatToGeminiStreamState any
 	ReceivedResponseCount   int
-	FinalPreConsumedQuota int // 最终预消耗的配额
+	FinalPreConsumedQuota   int // 最终预消耗的配额
 	// ForcePreConsume 为 true 时禁用 BillingSession 的信任额度旁路，
 	// 强制预扣全额。用于异步任务（视频/音乐生成等），因为请求返回后任务仍在运行，
 	// 必须在提交前锁定全额。
@@ -1018,16 +1018,17 @@ func (t *TaskSubmitReq) UnmarshalMetadata(v any) error {
 }
 type TaskInfo struct {
-	Code             int            `json:"code"`
+	Code             int             `json:"code"`
-	TaskID           string         `json:"task_id"`
+	TaskID           string          `json:"task_id"`
-	Status           string         `json:"status"`
+	Status           string          `json:"status"`
-	Reason           string         `json:"reason,omitempty"`
+	Reason           string          `json:"reason,omitempty"`
-	Url              string         `json:"url,omitempty"`
+	Url              string          `json:"url,omitempty"`
-	RemoteUrl        string         `json:"remote_url,omitempty"`
+	RemoteUrl        string          `json:"remote_url,omitempty"`
-	Progress         string         `json:"progress,omitempty"`
+	Progress         string          `json:"progress,omitempty"`
-	CompletionTokens int            `json:"completion_tokens,omitempty"` // 用于按倍率计费
+	CompletionTokens int             `json:"completion_tokens,omitempty"` // 用于按倍率计费
-	TotalTokens      int            `json:"total_tokens,omitempty"`      // 用于按倍率计费
+	TotalTokens      int             `json:"total_tokens,omitempty"`      // 用于按倍率计费
-	UsageFacts       map[string]any `json:"usage_facts,omitempty"`
+	UsageFacts       map[string]any  `json:"usage_facts,omitempty"`
+	PluginState      json.RawMessage `json:"plugin_state,omitempty"`
 }
 func FailTaskInfo(reason string) *TaskInfo {

--- a/relay/relay_task.go
+++ b/relay/relay_task.go
@@ -32,6 +32,7 @@ type TaskSubmitResult struct {
 	Platform       constant.TaskPlatform
 	Quota          int
 	Immediate      *relaycommon.TaskInfo
+	PluginState    []byte
 	//PerCallPrice   types.PriceData
 }
@@ -381,6 +382,7 @@ func RelayTaskSubmit(c *gin.Context, info *relaycommon.RelayInfo) (*TaskSubmitRe
 		Platform:       platform,
 		Quota:          finalQuota,
 		Immediate:      parsed.Immediate,
+		PluginState:    parsed.PluginState,
 	}, nil
 }
@@ -517,12 +519,7 @@ func tryRealtimeFetch(task *model.Task, isOpenAIVideoAPI bool) []byte {
 		return nil
 	}
-	resp, err := adaptor.FetchTask(baseURL, channelModel.Key, map[string]any{
+	resp, err := adaptor.FetchTask(baseURL, channelModel.Key, task, proxy)
-		"task_id":        task.GetUpstreamTaskID(),
-		"action":         constant.NormalizeTaskAction(task.Action),
-		"model":          task.Properties.OriginModelName,
-		"upstream_model": task.Properties.UpstreamModelName,
-	}, proxy)
 	if err != nil || resp == nil {
 		return nil
 	}
@@ -532,7 +529,7 @@ func tryRealtimeFetch(task *model.Task, isOpenAIVideoAPI bool) []byte {
 		return nil
 	}
-	ti, err := adaptor.ParseTaskResult(body)
+	ti, err := adaptor.ParseTaskResult(task, resp, body)
 	if err != nil || ti == nil {
 		return nil
 	}

--- a/service/task_billing_test.go
+++ b/service/task_billing_test.go
@@ -1343,10 +1343,12 @@ type mockAdaptor struct {
 }
 func (m *mockAdaptor) Init(_ *relaycommon.RelayInfo) {}
-func (m *mockAdaptor) FetchTask(string, string, map[string]any, string) (*http.Response, error) {
+func (m *mockAdaptor) FetchTask(string, string, *model.Task, string) (*http.Response, error) {
+	return nil, nil
+}
+func (m *mockAdaptor) ParseTaskResult(*model.Task, *http.Response, []byte) (*relaycommon.TaskInfo, error) {
 	return nil, nil
 }
-func (m *mockAdaptor) ParseTaskResult([]byte) (*relaycommon.TaskInfo, error) { return nil, nil }
 func (m *mockAdaptor) AdjustBillingOnComplete(_ *model.Task, _ *relaycommon.TaskInfo) int {
 	return m.adjustReturn
 }

--- a/service/task_plugin_view_test.go
+++ b/service/task_plugin_view_test.go
@@ -62,3 +62,24 @@ func TestBuildTaskPluginViewRewritesOnlyStructuredTaskIDFields(t *testing.T) {
 	assert.Equal(t, privateTaskID, nested[1])
 }
+func TestBuildTaskPluginViewOmitsPrivatePollState(t *testing.T) {
+	task := &model.Task{
+		TaskID: "task_public_view",
+		Data:   []byte(`{"ok":true}`),
+		PrivateData: model.TaskPrivateData{
+			PluginState:  []byte(`{"req_key":"secret"}`),
+			PollFailures: 7,
+		},
+	}
+	view, err := BuildTaskPluginView(task)
+	require.NoError(t, err)
+	encoded, err := common.Marshal(view)
+	require.NoError(t, err)
+	var payload map[string]any
+	require.NoError(t, common.Unmarshal(encoded, &payload))
+	assert.NotContains(t, payload, "plugin_state")
+	assert.NotContains(t, payload, "poll_failures")
+	assert.NotContains(t, payload, "private_data")
+}
--- a/service/task_polling.go
+++ b/service/task_polling.go
--- a/service/task_polling_test.go
+++ b/service/task_polling_test.go