cuelo 0.5.2 → 0.5.4

package/Tools/OMP_Global_Config/patches/apply-core-patch.mjs

@@ -64,15 +64,17 @@ const EDITS = [
 		patched: "\thasSteeringMessages?: () => boolean | SteeringQueueState | Promise<boolean | SteeringQueueState>;\n\t/** Non-consuming full queue snapshot for generation-time user steering. */\n\tpeekSteeringMessages?: () => readonly AgentMessage[];\n\t/** Notify an active response before newly queued user steering can race speculative admission. */\n\tonUserSteeringQueued?: (listener: () => void) => () => void;",
 	},
 	{
+		// 18.3.3은 hasSteeringMessages 본문을 `steeringQueueState(...)` 호출 한 줄로 바꿨다
+		// (agent.ts:1772). 두 속성(peek·listener)은 그 속성 바로 앞에 붙는 의미 그대로다.
 		file: "../pi-agent-core/src/agent.ts",
 		marker: "onUserSteeringQueued: listener => {",
-		anchor: "\t\t\thasSteeringMessages: () => {",
+		anchor: "\t\t\thasSteeringMessages: () =>",
 		patched: `			peekSteeringMessages: () => this.peekSteeringQueue(),
 			onUserSteeringQueued: listener => {
 				this.#userSteeringListeners.add(listener);
 				return () => this.#userSteeringListeners.delete(listener);
 			},
-			hasSteeringMessages: () => {`,
+			hasSteeringMessages: () =>`,
 	},
 	{
 		// A speculative read may have physically started before the steer
@@ -2401,13 +2403,17 @@ async function loadExternalMakerRuntime(
 		patched: "\t/** Per-spawn thinking effort (flat form): lowest/middle/highest level the resolved model supports. */\n\teffort?: \"lo\" | \"med\" | \"hi\";\n\t/**\n\t * Standard model selector for this spawn (flat form), e.g. \"provider/model-id:max\".\n\t * Same forwarding and fall-through semantics as the batch item field.\n\t */\n\tmodel?: string;",
 	},
 	{
+		// 18.3.4는 모든 task schema에 필수 `solutionSpace: "string"` 을 `task` 바로 뒤에 넣었다
+		// (types.ts:52-185). per-spawn `model?` 은 그 필수 필드 뒤에 둔다. 의미는 18.3.2와 같다.
 		file: "src/task/types.ts",
 		marker: `task: "string",
+	solutionSpace: "string",
 	"model?": "string",`,
 		anchor: `export const taskItemSchema = type({
 	"name?": "string",
 	agent: "string = 'task'",
 	task: "string",
+	solutionSpace: "string",
 	"outputSchema?": outputSchemaInputSchema,
 	"schemaMode?": '"permissive" | "strict"',
 	"tools?": "string[]",
@@ -2417,6 +2423,7 @@ const taskItemSchemaIsolated = type({
 	"name?": "string",
 	agent: "string = 'task'",
 	task: "string",
+	solutionSpace: "string",
 	"outputSchema?": outputSchemaInputSchema,
 	"schemaMode?": '"permissive" | "strict"',
 	"tools?": "string[]",
@@ -2427,6 +2434,7 @@ const taskItemSchemaIsolated = type({
 	"name?": "string",
 	agent: "string = 'task'",
 	task: "string",
+	solutionSpace: "string",
 	"model?": "string",
 	"outputSchema?": outputSchemaInputSchema,
 	"schemaMode?": '"permissive" | "strict"',
@@ -2437,6 +2445,7 @@ const taskItemSchemaIsolated = type({
 	"name?": "string",
 	agent: "string = 'task'",
 	task: "string",
+	solutionSpace: "string",
 	"model?": "string",
 	"outputSchema?": outputSchemaInputSchema,
 	"schemaMode?": '"permissive" | "strict"',
@@ -2447,43 +2456,45 @@ const taskItemSchemaIsolated = type({
 	},
 	{
 		file: "src/task/types.ts",
-		marker: `	task: "string",
-	"model?": "string",
-	"outputSchema?": outputSchemaInputSchema,
-	"schemaMode?": '"permissive" | "strict"',
-	"tools?": "string[]",
-	"isolated?": "boolean",`,
+		marker: `export const taskSchema = type({
+	"name?": "string",
+	agent: "string = 'task'",
+	task: "string",
+	solutionSpace: "string",
+	"model?": "string",`,
 		anchor: `export const taskSchema = type({
 	"name?": "string",
 	agent: "string = 'task'",
 	task: "string",
+	solutionSpace: "string",
 	"outputSchema?": outputSchemaInputSchema,`,
 		patched: `export const taskSchema = type({
 	"name?": "string",
 	agent: "string = 'task'",
 	task: "string",
+	solutionSpace: "string",
 	"model?": "string",
 	"outputSchema?": outputSchemaInputSchema,`,
 	},
 	{
 		file: "src/task/types.ts",
-		marker: `	task: "string",
-	"model?": "string",
-	"outputSchema?": outputSchemaInputSchema,
-	"schemaMode?": '"permissive" | "strict"',
-	"tools?": "string[]",
-	"+": "delete",
-});
-const taskSchemaBatch = type({`,
+		marker: `const taskSchemaNoIsolation = type({
+	"name?": "string",
+	agent: "string = 'task'",
+	task: "string",
+	solutionSpace: "string",
+	"model?": "string",`,
 		anchor: `const taskSchemaNoIsolation = type({
 	"name?": "string",
 	agent: "string = 'task'",
 	task: "string",
+	solutionSpace: "string",
 	"outputSchema?": outputSchemaInputSchema,`,
 		patched: `const taskSchemaNoIsolation = type({
 	"name?": "string",
 	agent: "string = 'task'",
 	task: "string",
+	solutionSpace: "string",
 	"model?": "string",
 	"outputSchema?": outputSchemaInputSchema,`,
 	},
@@ -2502,6 +2513,7 @@ const taskSchemaBatch = type({`,
 				"name?": "string",
 				agent,
 				task: "string",
+				solutionSpace: "string",
 				...effortField,
 				"outputSchema?": outputSchemaInputSchema,
 				"schemaMode?": '"permissive" | "strict"',
@@ -2514,6 +2526,7 @@ const taskSchemaBatch = type({`,
 				"name?": "string",
 				agent,
 				task: "string",
+				solutionSpace: "string",
 				"model?": "string",
 				...effortField,
 				"outputSchema?": outputSchemaInputSchema,
@@ -2536,6 +2549,7 @@ const taskSchemaBatch = type({`,
 			"name?": "string",
 			agent,
 			task: "string",
+			solutionSpace: "string",
 			...effortField,
 			"outputSchema?": outputSchemaInputSchema,
 			"schemaMode?": '"permissive" | "strict"',
@@ -2546,6 +2560,7 @@ const taskSchemaBatch = type({`,
 			"name?": "string",
 			agent,
 			task: "string",
+			solutionSpace: "string",
 			"model?": "string",
 			...effortField,
 			"outputSchema?": outputSchemaInputSchema,
@@ -2582,12 +2597,42 @@ const taskSchemaBatch = type({`,
 		file: "src/task/index.ts",
 		marker: `...(params.model !== undefined ? { model: params.model } : {}),
 				...(params.tools?.length`,
+		// 18.3.4는 effort 다음 줄에 `solutionSpace: params.solutionSpace,` 를 넣었다(index.ts:1506).
 		anchor: `				...(params.effort !== undefined ? { effort: params.effort } : {}),
+				solutionSpace: params.solutionSpace,
 				...(params.tools?.length`,
 		patched: `				...(params.effort !== undefined ? { effort: params.effort } : {}),
+				solutionSpace: params.solutionSpace,
 				...(params.model !== undefined ? { model: params.model } : {}),
 				...(params.tools?.length`,
 	},
+	{
+		// 18.3.3 BLOCK: upstream 은 `task`·`bash` 를 가진 SubAgent 정의에 `wait` 를 자동으로 더한다
+		// (executor.ts:3505-3516). CUELO 계약은 Main 전용 wait 다(harness-policy
+		// `mainLane.waitContract.barrierCall`: subagents have no wait tool, 자기 job 결과는 자동으로
+		// 다시 깨운다). Maker 정의는 bash 를 가지므로 이 확장이 곧 모든 Maker 에 wait 를 준다
+		// (격리 18.3.4 probe: maker[read,bash] → [read,bash,wait,yield]). 자동 확장만 막고, agent
+		// 정의가 `wait` 를 직접 적은 경우(upstream 의 "explicitly requested" 경로)는 그대로 받는다.
+		file: "src/task/executor.ts",
+		marker: "// HANSE: wait stays Main-only; a subagent gets it only from its own definition.",
+		anchor: `	// Agents that can start background work (\`task\`, \`bash\`) need \`wait\` to block on it;
+	// without it they \`sleep\`. Runs after \`exec\` expansion and the max-depth \`task\` strip.
+	// \`createTools\` still drops it when no wake source (async/IRC/services) is enabled.
+	// Restricted sessions own their explicit list and are never widened.
+	if (
+		toolNames &&
+		!options.restrictToolNames &&
+		!toolNames.includes("wait") &&
+		(toolNames.includes("task") || toolNames.includes("bash"))
+	) {
+		toolNames = [...toolNames, "wait"];
+	}
+`,
+		patched: `	// HANSE: wait stays Main-only; a subagent gets it only from its own definition.
+	// Upstream widened every task/bash subagent here; CUELO subagents are re-woken by
+	// their own job results instead of blocking on \`wait\`.
+`,
+	},
 	// --- BAI socket/stream-read fallback 회귀 수리 (ArenaInterface 제안 inline, proposal 파일로 분리하지 않음) ---
 	// 범위: unexpected socket close / stream-read 이송 오류만 같은 모델 재시도 우선. 그 외 network 오류·
 	// UsageLimit·타 provider·abort·credential·unsafe replay 의미는 기존 그대로. 새 retry loop·설정·전역 gate 없음.
@@ -4565,60 +4610,14 @@ import { getActiveRules } from "../capability/rule";`,
 				: rawOutput;
 	}`,
 	},
-	{
-		// 2026-09-25 사용자 결정: OAuth 요청의 64K 출력 상한(Claude Code fingerprint)을 풀고
-		// 모델 상한(Opus 5.5 128K)을 쓴다. high thinking이 64K에 걸려 본문 없이 `length`로
-		// 끊긴 실측(Tools/OMP_Global_Config/doc/history/2026/09/25-mega-timing/main.md).
-		file: "../pi-ai/src/providers/anthropic.ts",
-		marker: "const maxOutputTokens = modelMaxTokens; // HANSE: OAuth 64K clamp removed",
-		anchor: "\tconst maxOutputTokens = isOAuthToken ? Math.min(CLAUDE_CODE_MAX_OUTPUT_TOKENS, modelMaxTokens) : modelMaxTokens;",
-		patched: "\tconst maxOutputTokens = modelMaxTokens; // HANSE: OAuth 64K clamp removed",
-	},
-	{
-		// 2026-09-25 사용자 결정: 문맥이 작은데 thinking만 하다 `length`로 끊기면 upstream은
-		// recovery compaction을 돌려 그 사고를 통째로 버린다(mega-six Markdown Maker: 59K 문맥,
-		// 요약 "No prior history" 뒤 421초 재사고). 입력 문맥이 창의 절반 미만이면 compaction 대신
-		// 죽은 턴만 버리고 짧게 결론 내라는 developer 안내를 넣어 이어 간다. 기존 재시도 상한을 공유한다.
-		file: "src/session/session-maintenance.ts",
-		marker: "source: \"hanse-length-nudge\"",
-		anchor: "\t\t\tconst promoted = await this.#tryContextPromotion(assistantMessage);\n\t\t\tif (promoted) {\n\t\t\t\tawait this.#host.dropPersistedAssistantTurn(assistantMessage);\n\t\t\t\tthis.#incompleteRecoveryAttempts = 0;\n\t\t\t\tlogger.debug(\"Context promotion triggered by response.incomplete (length stop)\", {",
-		patched: `			const hanseUsage = assistantMessage.usage;
-			const hanseInputTokens = (hanseUsage?.input ?? 0) + (hanseUsage?.cacheRead ?? 0) + (hanseUsage?.cacheWrite ?? 0);
-			const hanseWindow = this.#host.model()?.contextWindow ?? 0;
-			const hanseReasoningOnly = !assistantMessage.content.some(
-				c => c.type === "toolCall" || (c.type === "text" && c.text.trim().length > 0),
-			);
-			if (
-				hanseReasoningOnly &&
-				hanseWindow > 0 &&
-				hanseInputTokens < hanseWindow * 0.5 &&
-				this.#incompleteRecoveryAttempts < INCOMPLETE_RECOVERY_MAX_RETRIES
-			) {
-				this.#incompleteRecoveryAttempts++;
-				await this.#host.dropPersistedAssistantTurn(assistantMessage);
-				this.#host.agent.appendMessage({
-					role: "developer",
-					content: [
-						{
-							type: "text",
-							text: "Your previous response hit the output token limit while still reasoning and produced no text or tool call; that reasoning was lost. Do not re-derive the whole design. Reason briefly, then immediately make the next concrete tool call (write/edit the code in small steps).",
-						},
-					],
-					attribution: "agent",
-					timestamp: Date.now(),
-					synthetic: true,
-				});
-				logger.debug("HANSE length nudge instead of compaction", { inputTokens: hanseInputTokens, window: hanseWindow });
-				this.#host.scheduleAgentContinue({ source: "hanse-length-nudge", delayMs: 100, generation });
-				return COMPACTION_CHECK_CONTINUATION;
-			}
-
-			const promoted = await this.#tryContextPromotion(assistantMessage);
-			if (promoted) {
-				await this.#host.dropPersistedAssistantTurn(assistantMessage);
-				this.#incompleteRecoveryAttempts = 0;
-				logger.debug("Context promotion triggered by response.incomplete (length stop)", {`,
-	},
+	// 18.3.4 RETIRE: OAuth 64K 출력 상한 해제(옛 2026-09-25 항목). pi-ai 18.3.4 anthropic.ts:4743 이
+	// OAuth·API key 모두 `model.maxTokens ?? 64_000` 을 요청한다(CHANGELOG 18.3.4 "Fixed Anthropic OAuth
+	// requests capping output at 64k tokens"; Opus 5.5 128k).
+	// 18.3.4 RETIRE: reasoning-only `length` 뒤 compaction 대신 짧게 이어 가라는 nudge(옛 hanse-length-nudge).
+	// session-maintenance.ts:3104-3134 가 창 여유(compaction 임계 90% 미만)에서 죽은 턴만 버리고
+	// `length-stop-retry.md` 안내를 넣어 재시도하며, 상한 도달 시 3083-3101 이 retainTerminalFailure 로
+	// 실패를 남긴다. 옛 조건(입력 < 창 50%)의 상위집합이다. 유일한 차이였던 context promotion 선행은
+	// `contextPromotion.enabled` 기본 false·CUELO 미설정이라 동작 차이가 없다.
 	{
 		// 2026-09-25: steering-reply gate가 스트리밍 이벤트 순서에 기대면, 도구가 미리 실행될 때 같은 응답의
 		// 앞선 답 텍스트를 보지 못해 잘못 막는다. 판정 대상 assistant 메시지를 tool_call 이벤트에 싣는다.
@@ -4627,23 +4626,35 @@ import { getActiveRules } from "../capability/rule";`,
 		anchor: "\t\t\t\ttype: \"tool_call\",\n\t\t\t\ttoolName: ctx.tool.name,\n\t\t\t\ttoolCallId: ctx.toolCall.id,\n",
 		patched: "\t\t\t\ttype: \"tool_call\",\n\t\t\t\ttoolName: ctx.tool.name,\n\t\t\t\ttoolCallId: ctx.toolCall.id,\n\t\t\t\tassistantMessage: ctx.assistantMessage, // HANSE: steering gate\n",
 	},
-	// 2026-09-26: Opus 5.5는 도구 앞 사용자용 문장을 서명에 `narration`이 든 thinking 블록으로 보낸다.
-	// omitThinking(`display: "omitted"`)은 그 문장까지 비워서, 세션 79개 중 25개 메시지의 답이 화면·세션 파일에서
-	// 사라졌다(`T[thinking] T[narration] toolCall`). 요청은 summarized로 받고, omitThinking이면 thinking 내용은 계속
-	// 숨기되 narration만 본문 text 블록으로 보인다. 다시 보낼 때는 서명된 thinking을 원래대로 보내고 화면용 사본은 뺀다.
+	// 2026-09-27: Opus 5.5는 도구 앞 사용자용 문장(progress update)을 별도 서명의 thinking 블록으로 보낸다.
+	// omitThinking(`display: "omitted"`)은 그 문장까지 비운다(2026-09-26 세션 79개 중 25개 메시지의 답 소실).
+	// 공식 `display: "updates"`(beta)는 reasoning은 비운 채 progress update만 텍스트로 보내므로, 공식 Anthropic API의
+	// omitThinking 요청은 그 값으로 보내고 텍스트가 온 thinking을 본문 text 사본으로 보인다. 서명은 불투명 값이라
+	// 해석하지 않는다. 다시 보낼 때는 서명된 thinking을 원래대로 보내고 화면용 사본은 뺀다.
 	{
 		file: "../pi-ai/src/providers/anthropic.ts",
-		marker: "function isHanseNarrationSignature(",
+		marker: "function isHanseThinkingUpdatesRequest(",
 		anchor: "function unwrapAnthropicThinkingEnvelope(text: string): string | undefined {\n",
 		patched: [
-			"/** HANSE: 도구 앞 사용자용 문장을 담은 thinking 블록인지 서명 안의 블록 종류 이름으로 본다(2026-09-26 실측). */",
-			"function isHanseNarrationSignature(signature: string | undefined): boolean {",
-			"\tif (!signature) return false;",
-			"\ttry {",
-			"\t\treturn Buffer.from(signature, \"base64\").toString(\"latin1\").includes(\"narration\");",
-			"\t} catch {",
-			"\t\treturn false;",
-			"\t}",
+			"/** HANSE: `thinking.display: \"updates\"`는 이 beta 헤더와 함께 보내야 받는다. */",
+			"const HANSE_THINKING_DISPLAY_UPDATES_BETA = \"thinking-display-updates-2026-08-18\";",
+			"",
+			"/** HANSE: omitThinking 요청을 공식 progress-update 경로로 보낼지. 요청(buildParams)·beta·스트림이 같은 판정을 쓴다. */",
+			"function isHanseThinkingUpdatesRequest(",
+			"\tmodel: Model<\"anthropic-messages\">,",
+			"\toptions: AnthropicOptions | undefined,",
+			"\tbaseUrl: string | undefined,",
+			"): boolean {",
+			"\treturn (",
+			"\t\toptions?.thinkingDisplay === \"omitted\" &&",
+			"\t\toptions.client === undefined &&",
+			"\t\tmodel.reasoning &&",
+			"\t\t(options.thinkingEnabled === true || model.compat.requiresThinkingEnabled === true) &&",
+			"\t\tmodel.thinking?.mode === \"anthropic-adaptive\" &&",
+			"\t\t!model.compat.disableAdaptiveThinking &&",
+			"\t\tmodel.thinking.supportsDisplay === true &&",
+			"\t\tisOfficialAnthropicApiUrl(baseUrl)",
+			"\t);",
 			"}",
 			"",
 			"function unwrapAnthropicThinkingEnvelope(text: string): string | undefined {",
@@ -4652,11 +4663,11 @@ import { getActiveRules } from "../capability/rule";`,
 	},
 	{
 		file: "../pi-ai/src/providers/anthropic.ts",
-		marker: "const hanseHideThinking = options?.thinkingDisplay === \"omitted\";",
+		marker: "const hanseThinkingUpdates = isHanseThinkingUpdatesRequest(model, options, baseUrl);",
 		anchor: "\t\t\tconst finalizeStreamBlock = (block: Block, contentIndex: number): void => {\n",
 		patched: [
-			"\t\t\t// HANSE: omitThinking은 thinking 내용을 숨기되 도구 앞 narration 문장은 본문으로 보인다.",
-			"\t\t\tconst hanseHideThinking = options?.thinkingDisplay === \"omitted\";",
+			"\t\t\t// HANSE: updates로 보낸 요청에서 텍스트가 온 thinking은 progress update다. 그 문장만 본문으로 보인다.",
+			"\t\t\tconst hanseThinkingUpdates = isHanseThinkingUpdatesRequest(model, options, baseUrl);",
 			"\t\t\tconst finalizeStreamBlock = (block: Block, contentIndex: number): void => {",
 			"",
 		].join("\n"),
@@ -4667,8 +4678,8 @@ import { getActiveRules } from "../capability/rule";`,
 		anchor: "\t\t\t\t\t\t\t\tstreamedReplayUnsafeContent = true;\n\t\t\t\t\t\t\t\tblock.thinking += event.delta.thinking;\n",
 		patched: [
 			"\t\t\t\t\t\t\t\tstreamedReplayUnsafeContent = true;",
-			"\t\t\t\t\t\t\t\tif (hanseHideThinking) {",
-			"\t\t\t\t\t\t\t\t\t// narration인지는 블록 끝의 서명으로만 알 수 있어, 그때까지 화면에 내보내지 않고 모은다.",
+			"\t\t\t\t\t\t\t\tif (hanseThinkingUpdates) {",
+			"\t\t\t\t\t\t\t\t\t// 서명된 블록은 비워 둔 채 보내고, 모은 문장은 블록 끝에서 본문 사본으로 내보낸다.",
 			"\t\t\t\t\t\t\t\t\tconst hanseBlock = block as Block & { hanseHiddenThinking?: string };",
 			"\t\t\t\t\t\t\t\t\thanseBlock.hanseHiddenThinking = (hanseBlock.hanseHiddenThinking ?? \"\") + event.delta.thinking;",
 			"\t\t\t\t\t\t\t\t\tcontinue;",
@@ -4683,11 +4694,11 @@ import { getActiveRules } from "../capability/rule";`,
 		anchor: "\t\t\t\t\tstream.push({ type: \"thinking_end\", contentIndex, content: block.thinking, partial: output });\n",
 		patched: [
 			"\t\t\t\t\tstream.push({ type: \"thinking_end\", contentIndex, content: block.thinking, partial: output });",
-			"\t\t\t\t\tif (hanseHideThinking) {",
+			"\t\t\t\t\tif (hanseThinkingUpdates) {",
 			"\t\t\t\t\t\tconst hanseBlock = block as Block & { hanseHiddenThinking?: string };",
 			"\t\t\t\t\t\tconst hanseHidden = (hanseBlock.hanseHiddenThinking ?? \"\").trim();",
 			"\t\t\t\t\t\tdelete hanseBlock.hanseHiddenThinking;",
-			"\t\t\t\t\t\tif (hanseHidden && isHanseNarrationSignature(block.thinkingSignature)) {",
+			"\t\t\t\t\t\tif (hanseHidden) {",
 			"\t\t\t\t\t\t\tconst narration = { type: \"text\", text: hanseHidden, hanseNarration: true, [kStreamingBlockIndex]: -1 } as unknown as Block;",
 			"\t\t\t\t\t\t\toutput.content.push(narration as AssistantMessage[\"content\"][number]);",
 			"\t\t\t\t\t\t\tconst narrationIndex = output.content.length - 1;",
@@ -4701,16 +4712,40 @@ import { getActiveRules } from "../capability/rule";`,
 	},
 	{
 		file: "../pi-ai/src/providers/anthropic.ts",
-		marker: "adaptive.display = \"summarized\"; // HANSE: narration",
+		marker: "display?: AnthropicThinkingDisplay | \"updates\" } = { type: \"adaptive\" }; // HANSE",
+		anchor: "const adaptive: { type: \"adaptive\"; display?: AnthropicThinkingDisplay } = { type: \"adaptive\" };",
+		patched: "const adaptive: { type: \"adaptive\"; display?: AnthropicThinkingDisplay | \"updates\" } = { type: \"adaptive\" }; // HANSE: progress-update display",
+	},
+	{
+		file: "../pi-ai/src/providers/anthropic.ts",
+		marker: "? \"updates\" : (thinkingOptions.thinkingDisplay ?? \"summarized\"); // HANSE",
 		anchor: "adaptive.display = thinkingOptions.thinkingDisplay ?? \"summarized\";",
-		patched: "adaptive.display = \"summarized\"; // HANSE: narration은 omitted에서 비므로 숨김은 스트림에서 한다",
+		patched: "adaptive.display = isHanseThinkingUpdatesRequest(model, options, effectiveBaseUrl ?? model.baseUrl) ? \"updates\" : (thinkingOptions.thinkingDisplay ?? \"summarized\"); // HANSE: omitThinking은 공식 progress-update 경로",
 	},
 	{
+		// 위 display와 짝: beta가 없으면 updates 요청은 거부된다. fallback-credit 재구성이 extraBetas를 비우므로 그 뒤에 붙인다.
 		file: "../pi-ai/src/providers/anthropic.ts",
-		marker: "display: \"summarized\", // HANSE: narration",
-		anchor: "display: thinkingOptions.thinkingDisplay ?? \"summarized\",",
-		patched: "display: \"summarized\", // HANSE: narration은 omitted에서 비므로 숨김은 스트림에서 한다",
+		marker: "extraBetas.push(HANSE_THINKING_DISPLAY_UPDATES_BETA);",
+		anchor: "\t\t\t\tclientArgs = {\n\t\t\t\t\tmodel,\n\t\t\t\t\tapiKey,\n\t\t\t\t\textraBetas,\n",
+		patched: [
+			"\t\t\t\tif (isHanseThinkingUpdatesRequest(model, options, baseUrl) && !extraBetas.includes(HANSE_THINKING_DISPLAY_UPDATES_BETA)) {",
+			"\t\t\t\t\textraBetas.push(HANSE_THINKING_DISPLAY_UPDATES_BETA);",
+			"\t\t\t\t}",
+			"\t\t\t\tclientArgs = {",
+			"\t\t\t\t\tmodel,",
+			"\t\t\t\t\tapiKey,",
+			"\t\t\t\t\textraBetas,",
+			"",
+		].join("\n"),
+	},
+	{
+		file: "../pi-ai/src/providers/anthropic-wire.ts",
+		marker: "display?: \"summarized\" | \"omitted\" | \"updates\"; // HANSE",
+		anchor: "export type ThinkingConfigAdaptive = {\n\ttype: \"adaptive\";\n\t/** Opus 4.7+ reasoning display mode. */\n\tdisplay?: \"summarized\" | \"omitted\";\n",
+		patched: "export type ThinkingConfigAdaptive = {\n\ttype: \"adaptive\";\n\t/** Opus 4.7+ reasoning display mode. */\n\tdisplay?: \"summarized\" | \"omitted\" | \"updates\"; // HANSE: progress-update display(beta)\n",
 	},
+	// 2026-09-27 RETIRE: budget(`type: "enabled"`) 경로의 summarized 강제. progress update는 adaptive 모델에만 있고
+	// 서명 판정을 없앴으므로, omitThinking에서 숨길 요약을 받아 올 이유가 없다(upstream 값을 그대로 쓴다).
 	{
 		file: "../pi-ai/src/providers/anthropic.ts",
 		marker: "\"hanseNarration\" in block && block.hanseNarration === true && hasSignedThinking",
@@ -4817,6 +4852,198 @@ export function hostNextServerEnvUnsets(
 		anchor: "\t\tcontent: [{ type: \"text\", text: errorMessage ? `${message}: ${errorMessage}` : `${message}.` }],\n",
 		patched: "\t\t// HANSE: skipped reason stands alone\n\t\tcontent: [{ type: \"text\", text: reason === \"skipped\" && errorMessage ? errorMessage : errorMessage ? `${message}: ${errorMessage}` : `${message}.` }],\n",
 	},
+	{
+		// 2026-09-25·27 실측: edit 거부 안내(seen-line guard)는 native 가 만든 영어 문장이라, Main 이 바로 다음
+		// 진행 문장을 영어로 이어 썼다. 문구는 pi-natives 바이너리 안에 있어 직접 못 고치지만 모델에는 이 파일의
+		// 오류 반환을 거쳐 간다. 알려진 문장 틀만 한국어로 바꾸고, 틀이 다르면 원문을 그대로 둔다.
+		file: "src/edit/index.ts",
+		marker: "// HANSE: localized seen-line rejection",
+		anchor: "function operationFromNative(op: string): Operation | undefined {\n",
+		patched: `// HANSE: localized seen-line rejection
+const SEEN_LINE_HEAD =
+	/^This edit anchors to lines (.+?) of (.+?) that (\\[[^\\]\\n]+\\]) never displayed \\(it showed a partial range, a search hit, or a folded summary\\)\\. (?:Actual file content at those lines|Preview of the actual file content at the first (\\d+) unseen line\\(s\\)):$/gm;
+const SEEN_LINE_TAIL =
+	/^Verify the content matches what you intend to touch, then re-issue the edit with the same \\[path#tag\\] header — a straight retry now succeeds without a re-read\\. If the content does NOT match, fix your line numbers\\.$/gm;
+export function localizeSeenLineRejection(text: string): string {
+	return text
+		.replace(
+			SEEN_LINE_HEAD,
+			(_match, lines: string, file: string, tag: string, preview: string | undefined) =>
+				"이 edit는 " + file + "의 " + lines + "번 줄을 기준으로 했지만, " + tag +
+				" 스냅샷은 그 줄을 온전히 보여 준 적이 없다(부분 범위·검색 결과·접힌 요약만 보였다). " +
+				(preview ? "보지 않은 줄 중 앞쪽 " + preview + "줄의 실제 내용:" : "그 줄의 실제 내용:"),
+		)
+		.replace(
+			SEEN_LINE_TAIL,
+			"건드리려던 내용과 맞는지 확인한 뒤 같은 [path#tag] 헤더로 edit를 다시 보낸다. 다시 읽지 않고 그대로 재시도해도 이제 성공한다. 내용이 다르면 줄 번호를 고친다.",
+		);
+}
+
+function operationFromNative(op: string): Operation | undefined {
+`,
+	},
+	{
+		file: "src/edit/index.ts",
+		marker: "text: localizeSeenLineRejection(outcome.text) }], isError: true };",
+		anchor: "\t\t\treturn { content: [{ type: \"text\", text: outcome.text }], isError: true };\n",
+		patched: "\t\t\treturn { content: [{ type: \"text\", text: localizeSeenLineRejection(outcome.text) }], isError: true };\n",
+	},
+	{
+		// 2026-09-27 자가학습 점검: Maker(taskDepth>0) 세션은 부모 state 의 alias 로 만들어지면서
+		// hasRecalledForFirstTurn=true 로 시작해, 자기 작업 brief 로는 한 번도 회상하지 않았다(작업 직전
+		// 교훈 적용 연결이 끊김). 첫 턴 회상 경로(beforeAgentStartPrompt)는 child 자기 state 를 쓰고, alias 는
+		// 부모와 같은 scoped 저장소를 공유하므로 이 값만 풀면 작업 brief 로 한 번 회상한다. 쓰기(retain)는
+		// 기존대로 alias 에서 막힌다.
+		file: "src/mnemopi/backend.ts",
+		marker: "// HANSE: child recalls its own task",
+		anchor: "\t\t\t\t\taliasOf: parent,\n\t\t\t\t\thasRecalledForFirstTurn: true,\n",
+		patched: "\t\t\t\t\taliasOf: parent,\n\t\t\t\t\t// HANSE: child recalls its own task\n\t\t\t\t\thasRecalledForFirstTurn: false,\n",
+	},
+	{
+		// 위 항목의 짝. child 는 부모의 첫 턴 회상(부모 첫 요청 기준)이 아니라 자기 작업 회상만 싣는다.
+		// 부모 snippet 을 계속 붙이면 child 첫 요청에 서로 다른 <memories> 두 벌이 실린다.
+		file: "src/mnemopi/backend.ts",
+		marker: "const recallSnippet = state?.aliasOf ? state.lastRecallSnippet : primary?.lastRecallSnippet;",
+		anchor: "\t\tif (primary?.lastRecallSnippet) parts.push(primary.lastRecallSnippet);\n",
+		patched: "\t\tconst recallSnippet = state?.aliasOf ? state.lastRecallSnippet : primary?.lastRecallSnippet;\n\t\tif (recallSnippet) parts.push(recallSnippet);\n",
+	},
+	{
+		// 주입되는 <memories> 줄에 기억 id 를 싣는다. recall 도구 결과에는 id 가 있지만 자동 주입 블록에는
+		// 없어서, 작업에 전달된 교훈을 routing_verdict appliedLessons 로 가리킬 수 없었다.
+		file: "src/mnemopi/state.ts",
+		marker: "// HANSE: recall line carries memory id",
+		anchor: "\t\treturn `- ${content}${source}${date}`;\n",
+		patched: "\t\t// HANSE: recall line carries memory id\n\t\tconst memoryId = result.id ? ` (id: ${result.id})` : \"\";\n\t\treturn `- ${content}${source}${date}${memoryId}`;\n",
+	},
+	{
+		// learn 은 rememberScoped 가 돌려준 기억 id 를 버리고 "Lesson stored." 만 알렸다. 교훈을 뒤에서
+		// 가리킬 식별자가 없으면 적용·결과를 연결할 수 없다. mnemopi 경로에서만 id 를 싣는다.
+		// 18.3.3은 호출을 `rememberScoped(memory, {...}, target)` 3인자로 펼쳤다(learn.ts:110-134,
+		// global scope 지원). 반환값(기억 id)은 그대로 string 이다.
+		file: "src/tools/learn.ts",
+		marker: "// HANSE: learn reports memory id",
+		anchor: "\t\t\ttry {\n\t\t\t\tstate.rememberScoped(\n",
+		patched: "\t\t\ttry {\n\t\t\t\t// HANSE: learn reports memory id\n\t\t\t\tconst memoryId = state.rememberScoped(\n",
+	},
+	{
+		file: "src/tools/learn.ts",
+		marker: "memoryMessage = `Lesson stored (id: ${memoryId})`;",
+		anchor: "\t\t\t\t\ttarget,\n\t\t\t\t);\n\t\t\t} catch (error) {\n",
+		patched: "\t\t\t\t\ttarget,\n\t\t\t\t);\n\t\t\t\tif (memoryId) memoryMessage = `Lesson stored (id: ${memoryId})`;\n\t\t\t} catch (error) {\n",
+	},
+	{
+		// 2026-09-27: 자동 주입 <memories> 는 세션 파일에 남지 않아, Main 단독 세션에서 어떤 교훈이 전달됐는지
+		// 셀 수 없었다(위임 attempt 만 routing_verdict appliedLessons 로 연결됨). 첫 턴 회상이 확정될 때 전달한
+		// 기억 id 를 LLM context 에 들어가지 않는 custom entry 로 남긴다. 소비자는 evals/analyze-lesson-recurrence.mjs.
+		file: "src/mnemopi/state.ts",
+		marker: "// HANSE: first-turn recall delivery is recorded",
+		anchor: "\t\t\t\tthis.hasRecalledForFirstTurn = true;\n\t\t\t\tif (context) this.lastRecallSnippet = context;\n",
+		patched: "\t\t\t\tthis.hasRecalledForFirstTurn = true;\n\t\t\t\tif (context) this.lastRecallSnippet = context;\n\t\t\t\t// HANSE: first-turn recall delivery is recorded\n\t\t\t\tconst deliveredIds = [...(context ?? \"\").matchAll(/\\(id: ([^)\\s]+)\\)/g)].map(match => match[1]);\n\t\t\t\tif (deliveredIds.length > 0) this.session.sessionManager.appendCustomEntry(\"mnemopi-recall\", { ids: deliveredIds });\n",
+	},
+	{
+		// 위 항목의 짝. 백그라운드 첫 턴 회상(maybeRecallOnAgentStart)도 같은 기록을 남긴다.
+		file: "src/mnemopi/state.ts",
+		marker: "// HANSE: background recall delivery is recorded",
+		anchor: "\t\tif (!context) return;\n\t\tthis.lastRecallSnippet = context;\n",
+		patched: "\t\tif (!context) return;\n\t\tthis.lastRecallSnippet = context;\n\t\t// HANSE: background recall delivery is recorded\n\t\tconst deliveredIds = [...context.matchAll(/\\(id: ([^)\\s]+)\\)/g)].map(match => match[1]);\n\t\tif (deliveredIds.length > 0) this.session.sessionManager.appendCustomEntry(\"mnemopi-recall\", { ids: deliveredIds });\n",
+	},
+	{
+		// 2026-09-27 도구 오류 집계(최근 7일 2,372건): `bash` 에 service 이름 없이 `env` 를 주면 거절돼
+		// 헛턴 하나를 썼다(사흘간 12건). 일반 명령에서는 env 를 명령 앞 `export` 로 바꿔 모든 실행
+		// 경로(셸·PTY·client terminal)에 같게 적용한다. ready 는 service 전용으로 그대로 둔다.
+		file: "src/tools/bash.ts",
+		marker: "// HANSE: env without a service name exports into the command",
+		anchor: "\t\t} else if (ready !== undefined || env !== undefined) {\n\t\t\tthrow new ToolError(\"ready and env require a service name.\");\n",
+		patched: "\t\t} else if (ready !== undefined) {\n\t\t\t// HANSE: env without a service name exports into the command\n\t\t\tthrow new ToolError(\"ready requires a service name.\");\n",
+	},
+	{
+		// 위 항목의 짝. 명령 검사(interceptor)·승인·worktree 재작성이 끝난 원래 명령 앞에만 붙인다.
+		file: "src/tools/bash.ts",
+		marker: "// HANSE: non-service env becomes a leading export",
+		anchor: "\t\tinvalidateGithubCacheForBashCommand(command);\n",
+		patched: `		invalidateGithubCacheForBashCommand(command);
+		// HANSE: non-service env becomes a leading export
+		if (name === undefined && env) {
+			const exports: string[] = [];
+			for (const [key, value] of Object.entries(env)) {
+				if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key)) throw new ToolError("Invalid env name: " + key);
+				exports.push("export " + key + "='" + value.replaceAll("'", "'\\\\''") + "'");
+			}
+			if (exports.length > 0) command = exports.join("; ") + "; " + command;
+		}
+`,
+	},
+	{
+		file: "src/prompts/tools/bash.md",
+		marker: "ready requires name; no async/timeout. env adds variables (without name: exported before the command)",
+		anchor: "unique name; ready/env require name; no async/timeout. env adds variables;",
+		patched: "unique name; ready requires name; no async/timeout. env adds variables (without name: exported before the command);",
+	},
+	{
+		// 같은 집계: `todo` append 에 phase 를 빠뜨리면 거절됐다(사흘간 9건). phase 가 없으면 아직 안 끝난
+		// 일이 있는 첫 phase, 없으면 마지막 phase, phase 가 없으면 init 기본 이름에 붙인다.
+		file: "src/tools/todo.ts",
+		marker: "// HANSE: append without phase targets the active phase",
+		anchor: "\tif (!entry.phase) {\n\t\terrors.push(\"Missing phase name for append operation\");\n\t\treturn phases;\n\t}\n",
+		patched: "\t// HANSE: append without phase targets the active phase\n\tconst targetPhase =\n\t\tentry.phase ||\n\t\tphases.find(phase => phase.tasks.some(task => task.status === \"in_progress\" || task.status === \"pending\" || task.status === \"blocked\"))?.name ||\n\t\tphases.at(-1)?.name ||\n\t\tDEFAULT_INIT_PHASE;\n",
+	},
+	{
+		file: "src/tools/todo.ts",
+		marker: "phase = { name: targetPhase, tasks: [] };",
+		anchor: "\tlet phase = findPhaseByName(phases, entry.phase);\n\tif (!phase) {\n\t\tphase = { name: entry.phase, tasks: [] };\n",
+		patched: "\tlet phase = findPhaseByName(phases, targetPhase);\n\tif (!phase) {\n\t\tphase = { name: targetPhase, tasks: [] };\n",
+	},
+	{
+		// 2026-09-27 edit 거절 조사: 7일 거절 174건 중 68건이 직전 edit 응답의 새 태그를 기준으로 했다. edit 가
+		// 성공하면 새 스냅샷은 응답에 보인 몇 줄만 '본 줄' 로 갖고, 전에 읽은 바뀌지 않은 줄은 잃었다(1~43줄 read →
+		// 5줄 edit → 30줄 edit 거절로 재현). 이전 태그의 본 줄을 두 스냅샷 사이 줄 대응으로 옮겨 새 태그에 더한다.
+		// 바뀐 줄은 옮기지 않으므로 '보지 않은 줄은 고치지 않는다' 는 가드 취지는 그대로다.
+		file: "src/edit/index.ts",
+		marker: "\tdiffLineRuns, // HANSE: seen-line carry\n",
+		anchor: "\tEditSession,\n\teditDescription,\n",
+		patched: "\tEditSession,\n\tdiffLineRuns, // HANSE: seen-line carry\n\teditDescription,\n",
+	},
+	{
+		file: "src/edit/index.ts",
+		marker: "// HANSE: carry seen lines across the edit",
+		anchor: "\t\tconst details = aggregateDetails(outcome.files, this.mode);\n",
+		patched: `		// HANSE: carry seen lines across the edit
+		const editInput = (params as { input?: unknown }).input;
+		if (this.mode === "hashline" && typeof editInput === "string") {
+			const store = getEditStore(this.session);
+			const pathKey = (value: string) => (process.platform === "win32" ? path.resolve(value).toLowerCase() : path.resolve(value));
+			const baseTags = new Map<string, string>();
+			for (const match of editInput.matchAll(/^\\[([^\\]\\n#]+)#([0-9A-Fa-f]{4})\\]/gm)) {
+				baseTags.set(pathKey(path.resolve(this.session.cwd, match[1].trim())), match[2].toUpperCase());
+			}
+			for (const file of outcome.files) {
+				if (file.op !== "update" || file.moveTo) continue;
+				const baseTag = baseTags.get(pathKey(file.path));
+				const newTag = store.headHash(file.path);
+				if (!baseTag || !newTag || newTag.toUpperCase() === baseTag) continue;
+				const seen = store.seenLines(file.path, baseTag);
+				const baseText = store.byHashText(file.path, baseTag);
+				const newText = store.headText(file.path);
+				if (!seen || seen.length === 0 || baseText === null || newText === null) continue;
+				const seenSet = new Set(seen);
+				const carried: number[] = [];
+				let oldLine = 1;
+				let newLine = 1;
+				for (const run of diffLineRuns(baseText.replace(/\\r\\n/g, "\\n"), newText.replace(/\\r\\n/g, "\\n"))) {
+					if (run.added) newLine += run.count;
+					else if (run.removed) oldLine += run.count;
+					else {
+						for (let offset = 0; offset < run.count; offset++) if (seenSet.has(oldLine + offset)) carried.push(newLine + offset);
+						oldLine += run.count;
+						newLine += run.count;
+					}
+				}
+				if (carried.length > 0) store.recordSeenLines(file.path, newTag, carried);
+			}
+		}
+		const details = aggregateDetails(outcome.files, this.mode);
+`,
+	},
 	{
 		// 2026-09-26 실측: `learn`/`retain` 은 `extract: true` 로 저장돼 원문 기억 1건에서 문장 단위 fact 가
 		// 파생된다(facts.source_msg_id = 원문 working id). fact 회수 결과에는 그 연결이 빠져 있어서, 세션 첫

package/install.mjs

@@ -29,7 +29,7 @@ export const HARNESS_ROLES = [
   "implDeepSeek",
   "makerHardUiOpus",
   "makerHardCodeOpus",
-  "makerHardCodeAstra",
+  "makerHardCodeSol",
 ];
 const SELECTOR = /^[^/\s:]+\/[^\s:]+(?::[a-z]+)?$/;