@deepseek-ai/dsh-command-goal 0.1.0-rc.7 → 0.1.0-rc.8

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/goal/command-goal/README.md
-README.md: ee32ea9e5b90d79f9912d7817d6f14b2227ece64
-README.zh.md: ee40cd4219c45b6d9650036fda21c56599be6abd
+README.md: 483f756517f511ec506868b008b88e99b2477dc0
+README.zh.md: cd3c396ad446721de4cc091d511b615149ab2b30

package/README.md

@@ -17,6 +17,8 @@ Human-facing `/goal` control over [`ctx.goals`](../goal/README.md). The plugin r
 
 Control words are case-insensitive only when they occupy the complete input. Every other non-empty suffix is an objective, so `/goal pause after verification` creates that literal objective. The goal domain trims and validates objectives. Because the generic command plane has no modal editor or confirmation primitive, `edit` takes its replacement inline and an unfinished replacement returns a direct error instructing the user to edit or clear.
 
+The command declares `input.images`, so composer image attachments may accompany an invocation. Attachments only accompany an objective: on a successful create or edit the producer submits one user followup carrying the admitted image blocks plus the fixed text `Reference images for the goal objective.`, so later goal rounds read them from ordinary session history without the goal domain storing attachment state. Every other sub-command, and any refused create or edit, returns a direct error and submits nothing, so the dispatching composer keeps the images.
+
 Expected domain rejections become stable direct command errors without exposing branded ids or revisions. Unexpected implementation failures still reject dispatch so adapters can report them as command failures. Generic command text and output remain live UI state; `dsh-goal` persists every accepted mutation through its own durable `goal/change` event.
 
 ## Composition
@@ -40,11 +42,11 @@ The shipped `dsh` base enables the persisted-goal stack and this command; the We
 
 #### What the model sees
 
-The slash input, mutation, and direct status/error output are absent from model requests. The goal domain records the mutation as `goal/change`; an enabled same-session driver may expose the resulting state in a later continuation prompt. Presentation text is never logged.
+The slash input, mutation, and direct status/error output are absent from model requests. The goal domain records the mutation as `goal/change`; an enabled same-session driver may expose the resulting state in a later continuation prompt. Presentation text is never logged. When a create or edit carries image attachments, the model sees one ordinary user message: the image blocks followed by the text `Reference images for the goal objective.`; it precedes the next goal round in session history.
 
 #### Token effect
 
-Reading status, mutating a goal, or receiving a direct command error adds no model tokens. An enabled same-session driver may add later goal-round prompts.
+Reading status, mutating a goal, or receiving a direct command error adds no model tokens. An enabled same-session driver may add later goal-round prompts. An objective's image attachments add one user message billed like any image prompt.
 
 #### KV Cache effect
 

package/README.zh.md

@@ -17,6 +17,8 @@
 
 只有控制词占据完整输入时才不区分大小写。其他任何非空后缀都属于目标，因此 `/goal pause after verification` 会创建该字面目标。goal 领域会去除目标首尾空白并进行验证。由于通用命令平面没有模态编辑器或确认原语，`edit` 会内联接收替换内容；若试图替换未完成的 goal，则直接返回错误，提示用户执行 edit 或 clear。
 
+该命令声明了 `input.images`，因此 composer 图片附件可以随调用一起提交。附件只随目标本身：create 或 edit 成功时，生产方提交一条用户 followup 消息，内容为已准入的图片块加固定文本 `Reference images for the goal objective.`，后续 Goal Round 从普通会话历史中读取它们，goal 领域不存储附件状态。其他任何子命令、以及被拒绝的 create 或 edit，都直接返回错误且不提交任何消息，分发方 composer 保留图片。
+
 可预期的领域拒绝会变成稳定的直接命令错误，不公开带品牌类型的 id 或 revision。意外实现失败仍会 reject 分发，使适配器能将其报告为命令失败。通用命令文本和输出仍属于实时 UI 状态；`dsh-goal` 通过自有的持久 `goal/change` 事件记录每项已接受变更。
 
 ## 组合
@@ -40,11 +42,11 @@
 
 #### 模型看到的内容
 
-斜杠输入、变更以及直接状态／错误输出不会进入模型请求。goal 领域把变更记录为 `goal/change`；已启用的同会话驱动器可以在后续继续执行提示词中暴露结果状态。呈现文本绝不会记录到日志中。
+斜杠输入、变更以及直接状态／错误输出不会进入模型请求。goal 领域把变更记录为 `goal/change`；已启用的同会话驱动器可以在后续继续执行提示词中暴露结果状态。呈现文本绝不会记录到日志中。当 create 或 edit 携带图片附件时，模型会看到一条普通用户消息：图片块后跟文本 `Reference images for the goal objective.`，在会话历史中位于下一个 Goal Round 之前。
 
 #### Token 影响
 
-读取状态、变更 goal 或收到直接命令错误不会增加模型 token。已启用的同会话驱动器可能增加后续 Goal Round 提示词。
+读取状态、变更 goal 或收到直接命令错误不会增加模型 token。已启用的同会话驱动器可能增加后续 Goal Round 提示词。目标携带的图片附件会增加一条用户消息，其计费与任何图片提示词相同。
 
 #### KV Cache 影响
 

package/lib/index.js

@@ -1,4 +1,5 @@
 import { GoalError } from "@deepseek-ai/dsh-goal";
+import { createUserMessage } from "@deepseek-ai/dsh-llm";
 //#region lib/types/index.js
 /**
 * Human-facing `/goal` command over the persisted same-session goal domain.
@@ -87,9 +88,29 @@ function missingGoal(action) {
 		text: `No goal is currently set; /goal ${action} requires one. ${USAGE}`
 	};
 }
+/**
+* Submit the invocation's admitted composer images as one model-visible user
+* message ahead of the goal's next round. The images precede a fixed text
+* block naming their role, so a later goal round reads them from ordinary
+* session history without the goal domain storing attachment state.
+*/
+function submitObjectiveAttachments(invocation) {
+	if (invocation.attachments.length === 0) return;
+	invocation.agent.followup(createUserMessage({
+		content: [...invocation.attachments, {
+			type: "text",
+			text: "Reference images for the goal objective."
+		}],
+		source: { kind: "user" }
+	}));
+}
 /** Execute one parsed human command through the domain that owns persistence. */
 function executeGoalCommand(ctx, invocation) {
 	const command = parseGoalCommand(invocation.rawInput);
+	if (invocation.attachments.length > 0 && command.kind !== "create" && command.kind !== "edit") return {
+		kind: "error",
+		text: "Image attachments only accompany a goal objective: /goal <objective> or /goal edit <objective>."
+	};
 	try {
 		const current = ctx.goals.get(invocation.agent);
 		switch (command.kind) {
@@ -101,16 +122,26 @@ function executeGoalCommand(ctx, invocation) {
 				kind: "error",
 				text: `Goal editing requires a replacement objective.\n${USAGE}`
 			};
-			case "create":
+			case "create": {
 				if (current !== void 0 && current.phase !== "complete") return {
 					kind: "error",
 					text: `A goal is already ${phaseLabel(current.phase)}. Use /goal edit <objective> to change it or /goal clear before replacing it.`
 				};
-				return renderGoal("Goal created", ctx.goals.create(invocation.agent, { objective: command.objective }));
-			case "edit":
+				const created = ctx.goals.create(invocation.agent, { objective: command.objective });
+				submitObjectiveAttachments(invocation);
+				return renderGoal("Goal created", created);
+			}
+			case "edit": {
 				if (current === void 0) return missingGoal("edit");
-				if (current.phase === "complete") return renderGoal("Goal created", ctx.goals.create(invocation.agent, { objective: command.objective }));
-				return renderGoal("Goal updated", ctx.goals.edit(invocation.agent, goalRef(current), { objective: command.objective }));
+				if (current.phase === "complete") {
+					const replaced = ctx.goals.create(invocation.agent, { objective: command.objective });
+					submitObjectiveAttachments(invocation);
+					return renderGoal("Goal created", replaced);
+				}
+				const edited = ctx.goals.edit(invocation.agent, goalRef(current), { objective: command.objective });
+				submitObjectiveAttachments(invocation);
+				return renderGoal("Goal updated", edited);
+			}
 			case "pause":
 				if (current === void 0) return missingGoal("pause");
 				return renderGoal("Goal paused", ctx.goals.pause(invocation.agent, goalRef(current)));
@@ -143,7 +174,10 @@ function apply(ctx) {
 	ctx.commands.register({
 		name: "goal",
 		description: "set or view the goal for a long-running task",
-		input: { hint: "[<objective>|clear|edit <objective>|pause|resume]" },
+		input: {
+			hint: "[<objective>|clear|edit <objective>|pause|resume]",
+			images: true
+		},
 		handler: (invocation) => executeGoalCommand(ctx, invocation)
 	});
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-command-goal",
   "description": "Human-facing slash command for persisted same-session goals",
-  "version": "0.1.0-rc.7",
+  "version": "0.1.0-rc.8",
   "publishConfig": {
     "access": "public"
   },
@@ -32,19 +32,20 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/dsh-commands": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-goal": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.7",
+    "@deepseek-ai/dsh-commands": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-goal": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-llm": "^0.1.0-rc.8",
     "@deepseek-ai/cordis": "^4.0.1"
   },
   "devDependencies": {
     "@deepseek-ai/cordis-plugin-loader": "^1.0.2",
-    "@deepseek-ai/dsh-agent": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-commands": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-llm": "^0.1.0-rc.7",
-    "@deepseek-ai/dsh-goal": "^0.1.0-rc.7",
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-session": "^0.1.0-rc.7"
+    "@deepseek-ai/dsh-agent": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-commands": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-goal": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-llm": "^0.1.0-rc.8",
+    "@deepseek-ai/dsh-session": "^0.1.0-rc.8",
+    "@deepseek-ai/cordis": "^4.0.1"
   }
 }