@dipoleml/dcode-cli 1.0.0 → 1.2.0

package/node_modules/@dcode/contracts/dist/interfaces/topic-resource.port.d.ts

@@ -0,0 +1,25 @@
+import type { TraceContext } from "../tracing/tracer.js";
+/** 仅用于当前任务已经接收的话题附件，身份由可信输入解析，不能由模型指定。 */
+export interface TopicResourcePort {
+    /** 同一可信 Host 渠道的显式发送能力；缺省不允许 CLI 自行寻找其他机器人凭据。 */
+    reply?(request: import("@dcode/shared").ChannelReplyRequest, context: {
+        signal: AbortSignal;
+        trace?: TraceContext;
+    }): Promise<import("@dcode/shared").ChannelReplyResult>;
+    read(request: {
+        taskId: string;
+        inputId: string;
+        authorizationId: string;
+        messageId: string;
+        resourceIndex: number;
+    }, context: {
+        signal: AbortSignal;
+        trace?: TraceContext;
+    }): Promise<{
+        ref: string;
+        fileName: string;
+        mime: string;
+        bytes: number;
+    }>;
+}
+//# sourceMappingURL=topic-resource.port.d.ts.map

package/node_modules/@dcode/contracts/dist/interfaces/topic-resource.port.js

@@ -0,0 +1 @@
+export {};

package/node_modules/@dcode/contracts/dist/model/index.d.ts

@@ -15,6 +15,7 @@ export type ModelId = string & {
 export declare const ModelRequestSessionType: {
     readonly Main: "main";
     readonly Other: "other";
+    readonly SideChat: "side_chat";
     readonly Subagent: "subagent";
 };
 /**
@@ -23,10 +24,14 @@ export declare const ModelRequestSessionType: {
  * - `unbounded`：**瞬态**失败无上限重试（退避曲线不变、封顶 60s 后无限探测），永久失败照旧立即抛。
  *   给 workflow actor（taskType workflow_child / nested_workflow_child）使用：模型错误绝不是
  *   workflow 错误，唯一出口是用户 cancel。
+ * - `single-attempt`：本次请求 maxAttempts 收敛为 1，瞬态失败也不重试、首次失败即上抛。
+ *   给带 selectionFallback 声明的执行作用域 Selection（如 Highspeed 加速卡）使用：失败后由 core
+ *   退回会话模型继续本轮，适配层再按默认 10 次退避重试只会把降级拖到数分钟之后。
  */
 export declare const ModelRetryBudget: {
     readonly Default: "default";
     readonly Unbounded: "unbounded";
+    readonly SingleAttempt: "single-attempt";
 };
 export type ModelRetryBudget = (typeof ModelRetryBudget)[keyof typeof ModelRetryBudget];
 /**
@@ -241,7 +246,16 @@ export interface ModelTelemetryMilestoneStatusEvent extends ModelNetworkStatusBa
     type: "model_first_provider_event" | "model_first_content" | "model_first_text";
     elapsedMs: number;
 }
-export type ModelNetworkStatusEvent = ModelRequestQueuedStatusEvent | ModelRequestAdmittedStatusEvent | ModelRequestStartedStatusEvent | ModelRequestCompletedStatusEvent | ModelRequestFailedStatusEvent | ModelRetryScheduledStatusEvent | ModelStreamStalledStatusEvent | ModelTelemetryMilestoneStatusEvent;
+/** 仅投递进程内 telemetry statusSink，不进入请求 UI 事件；字段不得携带凭据或用户内容。 */
+export type ModelRequestObservation = Readonly<{
+    kind: string;
+    [field: string]: string | number | boolean | undefined;
+}>;
+export interface ModelRequestObservationStatusEvent extends ModelNetworkStatusBase {
+    type: "model_request_observation";
+    observation: ModelRequestObservation;
+}
+export type ModelNetworkStatusEvent = ModelRequestQueuedStatusEvent | ModelRequestAdmittedStatusEvent | ModelRequestObservationStatusEvent | ModelRequestStartedStatusEvent | ModelRequestCompletedStatusEvent | ModelRequestFailedStatusEvent | ModelRetryScheduledStatusEvent | ModelStreamStalledStatusEvent | ModelTelemetryMilestoneStatusEvent;
 export interface ModelStatusSink {
     publish(event: ModelNetworkStatusEvent): void | Promise<void>;
     /**

package/node_modules/@dcode/contracts/dist/model/index.js

@@ -7,6 +7,7 @@ export * from "./invocation-context.js";
 export const ModelRequestSessionType = {
     Main: "main",
     Other: "other",
+    SideChat: "side_chat",
     Subagent: "subagent",
 };
 /**
@@ -15,10 +16,14 @@ export const ModelRequestSessionType = {
  * - `unbounded`：**瞬态**失败无上限重试（退避曲线不变、封顶 60s 后无限探测），永久失败照旧立即抛。
  *   给 workflow actor（taskType workflow_child / nested_workflow_child）使用：模型错误绝不是
  *   workflow 错误，唯一出口是用户 cancel。
+ * - `single-attempt`：本次请求 maxAttempts 收敛为 1，瞬态失败也不重试、首次失败即上抛。
+ *   给带 selectionFallback 声明的执行作用域 Selection（如 Highspeed 加速卡）使用：失败后由 core
+ *   退回会话模型继续本轮，适配层再按默认 10 次退避重试只会把降级拖到数分钟之后。
  */
 export const ModelRetryBudget = {
     Default: "default",
     Unbounded: "unbounded",
+    SingleAttempt: "single-attempt",
 };
 export const ModelErrorCode = {
     InvalidModelSelection: "invalid_model_selection",

package/node_modules/@dcode/contracts/dist/model/invocation-context.d.ts

@@ -1,3 +1,4 @@
+import type { RequestVerificationReason } from "@dcode/shared";
 import type { DCodeProviderAccountAccess } from "@dcode/shared";
 import type { ModelApiCallObservation } from "../telemetry/index.js";
 import type { TraceContext } from "../tracing/tracer.js";
@@ -23,8 +24,10 @@ export interface ModelInvocationContext {
     preserveProviderStreamBoundaries?: boolean;
     refreshRuntimeHeadersBeforeAttempt?: (input: {
         accountAccess?: DCodeProviderAccountAccess;
+        expectedAccountScope?: string;
+        rejectedProjectTokenFingerprint?: string;
         attempt: number;
-        reason?: "model-request";
+        reason?: RequestVerificationReason;
         abortSignal?: AbortSignal;
         providerId: string;
         modelId: string;
@@ -36,7 +39,9 @@ export interface ModelInvocationContext {
 }
 /** Adapter 为单个物理请求 attempt 使用的动态鉴权材料。 */
 export interface ModelRequestAuth {
+    accountScope?: string;
     apiKey?: string;
+    apiKeyId?: string;
     headers?: Record<string, string>;
 }
 export interface ModelRequestAuthSourceInput {

package/node_modules/@dcode/contracts/dist/plugins/index.d.ts

@@ -4,6 +4,7 @@ import type { McpServerConfig } from "../interfaces/mcp.port.js";
 import type { SkillRoot } from "../skills/index.js";
 import type { ExecutionContext, TraceContext } from "../tracing/tracer.js";
 export declare const DCODE_OFFICIAL_PLUGIN_MARKETPLACE = "dcode-plugins-official";
+export declare const CLAUDE_OFFICIAL_PLUGIN_MARKETPLACE = "claude-plugins-official";
 export declare const DCODE_INLINE_PLUGIN_MARKETPLACE = "inline";
 export declare const DCODE_PLUGIN_HOST_COMMAND = "__dcode-plugin-host";
 /**
@@ -133,9 +134,27 @@ export interface PluginManifest {
     repository?: string;
     settings?: unknown;
     skills?: unknown;
+    /** 插件 UI：`ui.surfaces[]` 面板入口声明，adapters 解析。 */
+    ui?: unknown;
     userConfig?: Record<string, PluginUserConfigOption>;
     version?: string;
 }
+/** 面板生命周期：第一版只接受会话级；`draft` 留待需要时放开。 */
+export type PluginUiSurfaceAvailability = "session";
+/** 标题：单一字符串或按 locale 键的映射（`{ "zh-CN": "...", "en-US": "..." }`）。 */
+export type PluginUiSurfaceTitle = string | Record<string, string>;
+export interface PluginUiSurfaceDefinition {
+    id: string;
+    title: PluginUiSurfaceTitle;
+    icon?: string;
+    /** 运行时 namespaced MCP server 名（`plugin:${name}:${server}`），UI 直接用它调 mcp/uiReadResource。 */
+    server: string;
+    /** 清单里声明的原始 server 键，仅供诊断与展示。 */
+    declaredServer: string;
+    /** 必须以 `ui://` 开头。 */
+    resourceUri: string;
+    availability: PluginUiSurfaceAvailability;
+}
 export interface PluginConfig {
     dirs: string[];
     enabled: boolean;
@@ -171,6 +190,8 @@ export interface PluginMetadata {
     skillCount: number;
     skillRootCount: number;
     source: PluginSource;
+    /** 清单 `ui.surfaces[]` 解析结果（已校验）；未声明或全部非法时缺省。 */
+    uiSurfaces?: PluginUiSurfaceDefinition[];
     userConfig?: Record<string, PluginUserConfigOption>;
     version?: string;
 }
@@ -206,6 +227,8 @@ export interface PluginReferenceCatalogEntry {
      * 禁止进入 provider reminder 或协议投影——路径不属于 identifiers-only 契约。
      */
     rootPath: string;
+    /** 面板入口声明（A5）；供 host 在 session 冻结 catalog 里查面板定义。 */
+    uiSurfaces?: PluginUiSurfaceDefinition[];
 }
 export interface PluginReferenceCatalog {
     plugins: PluginReferenceCatalogEntry[];

package/node_modules/@dcode/contracts/dist/plugins/index.js

@@ -1,4 +1,5 @@
 export const DCODE_OFFICIAL_PLUGIN_MARKETPLACE = "dcode-plugins-official";
+export const CLAUDE_OFFICIAL_PLUGIN_MARKETPLACE = "claude-plugins-official";
 export const DCODE_INLINE_PLUGIN_MARKETPLACE = "inline";
 export const DCODE_PLUGIN_HOST_COMMAND = "__dcode-plugin-host";
 /**
@@ -13,5 +14,5 @@ export const DCODE_PLUGIN_HOST_COMMAND = "__dcode-plugin-host";
  */
 export const DCODE_DWF_CHILD_COMMAND = "__dcode-dwf-child";
 export function isOfficialMarketplaceId(id) {
-    return id === DCODE_OFFICIAL_PLUGIN_MARKETPLACE;
+    return id === DCODE_OFFICIAL_PLUGIN_MARKETPLACE || id === CLAUDE_OFFICIAL_PLUGIN_MARKETPLACE;
 }

package/node_modules/@dcode/contracts/dist/telemetry/agent-execution.d.ts

@@ -7,6 +7,8 @@ export declare const AgentTelemetryOperation: {
     readonly GoalCompletionVerification: "goal_completion_verification";
     readonly GoalTitleGeneration: "goal_title_generation";
     readonly ProjectMemoryExtract: "project_memory_extract";
+    readonly ProjectMemoryDream: "project_memory_dream";
+    readonly ProjectMemoryRecall: "project_memory_recall";
     readonly ReadSessionContextExtract: "read_session_context_extract";
     readonly ReadSessionContextSynthesize: "read_session_context_synthesize";
     readonly SessionTitleGeneration: "session_title_generation";

package/node_modules/@dcode/contracts/dist/telemetry/agent-execution.js

@@ -5,6 +5,8 @@ export const AgentTelemetryOperation = {
     GoalCompletionVerification: "goal_completion_verification",
     GoalTitleGeneration: "goal_title_generation",
     ProjectMemoryExtract: "project_memory_extract",
+    ProjectMemoryDream: "project_memory_dream",
+    ProjectMemoryRecall: "project_memory_recall",
     ReadSessionContextExtract: "read_session_context_extract",
     ReadSessionContextSynthesize: "read_session_context_synthesize",
     SessionTitleGeneration: "session_title_generation",

package/node_modules/@dcode/contracts/dist/telemetry/index.d.ts

@@ -1,4 +1,4 @@
-import type { ModelId, ModelProviderId } from "../model/index.js";
+import type { ModelRequestObservation, ModelId, ModelProviderId } from "../model/index.js";
 import type { AgentExecutionTelemetryPort, AgentTelemetryAbandonReason, AgentTelemetryCancellationReason, AgentTelemetryErrorCategory, AgentTelemetryOperation, AgentTelemetryScope } from "./agent-execution.js";
 export * from "./agent-execution.js";
 export declare const ModelApiOperation: {
@@ -8,6 +8,8 @@ export declare const ModelApiOperation: {
     readonly GoalVerification: "goal_completion_verification";
     readonly GitCommitMessage: "workspace_git_commit_message";
     readonly ProjectMemoryExtract: "project_memory_extract";
+    readonly ProjectMemoryDream: "project_memory_dream";
+    readonly ProjectMemoryRecall: "project_memory_recall";
     readonly ReadSessionContextExtract: "read_session_context_extract";
     readonly ReadSessionContextSynthesize: "read_session_context_synthesize";
     readonly SessionTitle: "session_title_generation";
@@ -187,6 +189,8 @@ export interface ModelAttemptSpanWriter extends AgentTelemetryScope {
     markFirstContent(): void;
     markFirstText(): void;
     markStreamStalled(idleMs: number): void;
+    /** 请求观测交由发行实现映射到 Attribute 与 Event。 */
+    recordRequestObservation(observation: ModelRequestObservation): void;
     finishCompleted(): void;
     finishFailed(stage: ModelAttemptFailureStage, category: AgentTelemetryErrorCategory, error?: unknown): void;
     finishAbandoned(reason: AgentTelemetryAbandonReason): void;

package/node_modules/@dcode/contracts/dist/telemetry/index.js

@@ -6,6 +6,8 @@ export const ModelApiOperation = {
     GoalVerification: "goal_completion_verification",
     GitCommitMessage: "workspace_git_commit_message",
     ProjectMemoryExtract: "project_memory_extract",
+    ProjectMemoryDream: "project_memory_dream",
+    ProjectMemoryRecall: "project_memory_recall",
     ReadSessionContextExtract: "read_session_context_extract",
     ReadSessionContextSynthesize: "read_session_context_synthesize",
     SessionTitle: "session_title_generation",
@@ -90,6 +92,16 @@ function mapQuerySourceToModelApiOperation(querySource) {
                 operation: ModelApiOperation.ProjectMemoryExtract,
                 actorKind: ModelApiActorKind.System,
             };
+        case "project_memory_dream":
+            return {
+                operation: ModelApiOperation.ProjectMemoryDream,
+                actorKind: ModelApiActorKind.System,
+            };
+        case "project_memory_recall":
+            return {
+                operation: ModelApiOperation.ProjectMemoryRecall,
+                actorKind: ModelApiActorKind.System,
+            };
         default:
             return {
                 operation: ModelApiOperation.ToolInternalModelCall,

package/node_modules/@dcode/contracts/dist/tools/agent.d.ts

@@ -86,13 +86,13 @@ export declare const AgentCompletedOutputSchema: z.ZodObject<{
 }, "strict", z.ZodTypeAny, {
     description: string;
     status: "completed";
-    agentId: string;
-    agentType: string;
-    prompt: string;
     content: {
         type: "text";
         text: string;
     }[];
+    agentId: string;
+    agentType: string;
+    prompt: string;
     totalToolUseCount: number;
     totalDurationMs: number;
     usage?: Record<string, unknown> | undefined;
@@ -100,13 +100,13 @@ export declare const AgentCompletedOutputSchema: z.ZodObject<{
 }, {
     description: string;
     status: "completed";
-    agentId: string;
-    agentType: string;
-    prompt: string;
     content: {
         type: "text";
         text: string;
     }[];
+    agentId: string;
+    agentType: string;
+    prompt: string;
     totalToolUseCount: number;
     totalDurationMs: number;
     usage?: Record<string, unknown> | undefined;
@@ -169,13 +169,13 @@ export declare const AgentOutputSchema: z.ZodUnion<[z.ZodObject<{
 }, "strict", z.ZodTypeAny, {
     description: string;
     status: "completed";
-    agentId: string;
-    agentType: string;
-    prompt: string;
     content: {
         type: "text";
         text: string;
     }[];
+    agentId: string;
+    agentType: string;
+    prompt: string;
     totalToolUseCount: number;
     totalDurationMs: number;
     usage?: Record<string, unknown> | undefined;
@@ -183,13 +183,13 @@ export declare const AgentOutputSchema: z.ZodUnion<[z.ZodObject<{
 }, {
     description: string;
     status: "completed";
-    agentId: string;
-    agentType: string;
-    prompt: string;
     content: {
         type: "text";
         text: string;
     }[];
+    agentId: string;
+    agentType: string;
+    prompt: string;
     totalToolUseCount: number;
     totalDurationMs: number;
     usage?: Record<string, unknown> | undefined;

package/node_modules/@dcode/contracts/dist/tools/amend-workflow.d.ts

@@ -27,22 +27,23 @@ export declare const AmendWorkflowPredecessorSchema: z.ZodObject<{
     status: "pending" | "running" | "completed" | "stopped" | "errored";
     owned_by_this_session: boolean;
     name?: string | undefined;
-    stop_reason?: "user" | "model" | "provider" | "interrupted" | "superseded" | undefined;
+    stop_reason?: "model" | "user" | "provider" | "interrupted" | "superseded" | undefined;
     script_inherited?: true | undefined;
 }, {
     status: "pending" | "running" | "completed" | "stopped" | "errored";
     owned_by_this_session: boolean;
     name?: string | undefined;
-    stop_reason?: "user" | "model" | "provider" | "interrupted" | "superseded" | undefined;
+    stop_reason?: "model" | "user" | "provider" | "interrupted" | "superseded" | undefined;
     script_inherited?: true | undefined;
 }>;
 export type AmendWorkflowPredecessor = z.infer<typeof AmendWorkflowPredecessorSchema>;
 /**
- * 「这个前驱归本会话、且不是用户亲手停下的」——免确认的 owner 规则。
+ * 「这个前驱归本会话、且不是用户亲手停下的」——免确认的 owner 规则
+ * （docs/dynamic-workflow/launch.md「Amending this session's runs」）。
  *
  * 住在契约里而不是权限服务里，是因为它现在有**两个**读者，而两个读者必须一字不差地同意：
  * 权限服务据它在 always-ask 分支里放行，就地调并发遇上 `not_live` 时 handler 据它判断这次落回
- * 的修订本来要不要开窗。两处各写一遍，总有一天会让一条
+ * 的修订本来要不要开窗（「When the port says `not_live`」）。两处各写一遍，总有一天会让一条
  * 「什么都没批」的调用悄悄起一次新 run。
  *
  * 收 `unknown`：权限服务拿到的是还没解析的工具入参，handler 拿到的是解析好的事实块。
@@ -68,8 +69,8 @@ export declare const AmendWorkflowInputSchema: z.ZodObject<{
     path: z.ZodOptional<z.ZodString>;
     name: z.ZodOptional<z.ZodString>;
     /**
-     * 三态：省略 = 沿用前驱的上界、
-     * `null` = 解除（回到天花板）、数 = 设定（钳到天花板之下）。三态只活到 `resolveInput`：那里把它
+     * 三态（docs/dynamic-workflow/concurrency.md「Two bounds on a run」）：省略 = 沿用前驱的上界、
+     * `null` = 解除（回到默认并发）、数 = 设定（向下取整到至少 1，没有上限）。三态只活到 `resolveInput`：那里把它
      * 归一成一个数或缺席，确认窗与 handler 读到的就是将要生效的值。运行时 schema 保留 `nullable`
      * 是因为 hook 改写后 call-runner 会二次校验模型的原始形状。
      */
@@ -97,13 +98,13 @@ export declare const AmendWorkflowInputSchema: z.ZodObject<{
         status: "pending" | "running" | "completed" | "stopped" | "errored";
         owned_by_this_session: boolean;
         name?: string | undefined;
-        stop_reason?: "user" | "model" | "provider" | "interrupted" | "superseded" | undefined;
+        stop_reason?: "model" | "user" | "provider" | "interrupted" | "superseded" | undefined;
         script_inherited?: true | undefined;
     }, {
         status: "pending" | "running" | "completed" | "stopped" | "errored";
         owned_by_this_session: boolean;
         name?: string | undefined;
-        stop_reason?: "user" | "model" | "provider" | "interrupted" | "superseded" | undefined;
+        stop_reason?: "model" | "user" | "provider" | "interrupted" | "superseded" | undefined;
         script_inherited?: true | undefined;
     }>>;
     /**
@@ -111,38 +112,61 @@ export declare const AmendWorkflowInputSchema: z.ZodObject<{
      * 同一个姿态：解析结果，不是可填的参数，模型的 JSON schema 不列它。
      */
     script_line_offset: z.ZodOptional<z.ZodNumber>;
+    /** 确认窗可调的两项设置，与 CreateWorkflow 同一块、同一条回填规则（workflow-settings.ts）。 */
+    adjustable_settings: z.ZodOptional<z.ZodObject<{
+        subagent_model: z.ZodBoolean;
+        concurrency_ceiling: z.ZodOptional<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        subagent_model: boolean;
+        concurrency_ceiling?: number | undefined;
+    }, {
+        subagent_model: boolean;
+        concurrency_ceiling?: number | undefined;
+    }>>;
+    /** 新脚本点名的模型解析成的绑定表，与 CreateWorkflow 同一块（同名沿用前驱的绑定，见 launch.md）。 */
+    model_bindings: z.ZodOptional<z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodString>, Record<string, string>, Record<string, string>>>;
 }, "strict", z.ZodTypeAny, {
     run_id: string;
+    path?: string | undefined;
     script?: string | undefined;
     name?: string | undefined;
-    path?: string | undefined;
-    max_concurrency?: number | null | undefined;
     subagent_model?: string | null | undefined;
+    max_concurrency?: number | null | undefined;
     script_line_offset?: number | undefined;
+    adjustable_settings?: {
+        subagent_model: boolean;
+        concurrency_ceiling?: number | undefined;
+    } | undefined;
+    model_bindings?: Record<string, string> | undefined;
     predecessor?: {
         status: "pending" | "running" | "completed" | "stopped" | "errored";
         owned_by_this_session: boolean;
         name?: string | undefined;
-        stop_reason?: "user" | "model" | "provider" | "interrupted" | "superseded" | undefined;
+        stop_reason?: "model" | "user" | "provider" | "interrupted" | "superseded" | undefined;
         script_inherited?: true | undefined;
     } | undefined;
 }, {
     run_id: string;
+    path?: string | undefined;
     script?: string | undefined;
     name?: string | undefined;
-    path?: string | undefined;
-    max_concurrency?: number | null | undefined;
     subagent_model?: string | null | undefined;
+    max_concurrency?: number | null | undefined;
     script_line_offset?: number | undefined;
+    adjustable_settings?: {
+        subagent_model: boolean;
+        concurrency_ceiling?: number | undefined;
+    } | undefined;
+    model_bindings?: Record<string, string> | undefined;
     predecessor?: {
         status: "pending" | "running" | "completed" | "stopped" | "errored";
         owned_by_this_session: boolean;
         name?: string | undefined;
-        stop_reason?: "user" | "model" | "provider" | "interrupted" | "superseded" | undefined;
+        stop_reason?: "model" | "user" | "provider" | "interrupted" | "superseded" | undefined;
         script_inherited?: true | undefined;
     } | undefined;
 }>;
 export type AmendWorkflowInput = z.infer<typeof AmendWorkflowInputSchema>;
-/** 交给模型的 JSON schema：不含 `predecessor`，也不含 `script_line_offset`。 */
+/** 交给模型的 JSON schema：不含 `predecessor`、`script_line_offset`、`adjustable_settings` 与 `model_bindings`。 */
 export declare const AmendWorkflowInputJsonSchema: import("../index.js").JsonSchema;
 //# sourceMappingURL=amend-workflow.d.ts.map

package/node_modules/@dcode/contracts/dist/tools/amend-workflow.js

@@ -7,6 +7,7 @@
 // 后台追踪、`backgrounded` 契约与 display 载荷只有一份。
 import { z } from "zod";
 import { toToolJsonSchema } from "./json-schema.js";
+import { WorkflowAdjustableSettingsSchema, WorkflowModelBindingsSchema, } from "./workflow-settings.js";
 import { WORKFLOW_RUN_LIFECYCLE_STATUSES, WORKFLOW_RUN_STOP_REASONS, } from "./list-workflow-runs.js";
 export const AMEND_WORKFLOW_TOOL_NAME = "AmendWorkflow";
 /**
@@ -49,8 +50,8 @@ const AmendWorkflowModelInputSchema = z.object({
         .optional()
         .describe("Display label for the new run; defaults to the predecessor's."),
     /**
-     * 三态：省略 = 沿用前驱的上界、
-     * `null` = 解除（回到天花板）、数 = 设定（钳到天花板之下）。三态只活到 `resolveInput`：那里把它
+     * 三态（docs/dynamic-workflow/concurrency.md「Two bounds on a run」）：省略 = 沿用前驱的上界、
+     * `null` = 解除（回到默认并发）、数 = 设定（向下取整到至少 1，没有上限）。三态只活到 `resolveInput`：那里把它
      * 归一成一个数或缺席，确认窗与 handler 读到的就是将要生效的值。运行时 schema 保留 `nullable`
      * 是因为 hook 改写后 call-runner 会二次校验模型的原始形状。
      */
@@ -60,7 +61,7 @@ const AmendWorkflowModelInputSchema = z.object({
         .positive()
         .nullable()
         .optional()
-        .describe("Omit to keep the predecessor's limit, null to remove it, a number to set one (only when the user asks)."),
+        .describe("Omit to keep the predecessor's limit, null to return to the default, a number to set one above or below it (only when the user asks)."),
     /**
      * 三态，与 `max_concurrency` 逐字同规：
      * 省略 = 沿用前驱的选型（`resolveInput` 从前驱快照回填后**重新解析一次**，好让一个已经被
@@ -97,11 +98,12 @@ export const AmendWorkflowPredecessorSchema = z
 })
     .strict();
 /**
- * 「这个前驱归本会话、且不是用户亲手停下的」——免确认的 owner 规则。
+ * 「这个前驱归本会话、且不是用户亲手停下的」——免确认的 owner 规则
+ * （docs/dynamic-workflow/launch.md「Amending this session's runs」）。
  *
  * 住在契约里而不是权限服务里，是因为它现在有**两个**读者，而两个读者必须一字不差地同意：
  * 权限服务据它在 always-ask 分支里放行，就地调并发遇上 `not_live` 时 handler 据它判断这次落回
- * 的修订本来要不要开窗。两处各写一遍，总有一天会让一条
+ * 的修订本来要不要开窗（「When the port says `not_live`」）。两处各写一遍，总有一天会让一条
  * 「什么都没批」的调用悄悄起一次新 run。
  *
  * 收 `unknown`：权限服务拿到的是还没解析的工具入参，handler 拿到的是解析好的事实块。
@@ -123,6 +125,10 @@ export const AmendWorkflowInputSchema = AmendWorkflowModelInputSchema.extend({
      * 同一个姿态：解析结果，不是可填的参数，模型的 JSON schema 不列它。
      */
     script_line_offset: z.number().int().nonnegative().optional(),
+    /** 确认窗可调的两项设置，与 CreateWorkflow 同一块、同一条回填规则（workflow-settings.ts）。 */
+    adjustable_settings: WorkflowAdjustableSettingsSchema.optional(),
+    /** 新脚本点名的模型解析成的绑定表，与 CreateWorkflow 同一块（同名沿用前驱的绑定，见 launch.md）。 */
+    model_bindings: WorkflowModelBindingsSchema.optional(),
 }).strict();
-/** 交给模型的 JSON schema：不含 `predecessor`，也不含 `script_line_offset`。 */
+/** 交给模型的 JSON schema：不含 `predecessor`、`script_line_offset`、`adjustable_settings` 与 `model_bindings`。 */
 export const AmendWorkflowInputJsonSchema = toToolJsonSchema(AmendWorkflowModelInputSchema.strict());