dsh-strata-sync 0.10.3 → 0.10.4

package/README.md

@@ -69,7 +69,7 @@ For example, with automatic output calculation, a 32K context uses a 9,830-token
 
 ## Summary prompt and target length
 
-**Dynamic summary target** is enabled by default. It supplements DSH's native summary instructions; disabling it keeps native summary and compaction behavior.
+**Dynamic summary target** is off by default. Enable it to supplement DSH's native summary instructions. When off, DSH uses its native summary and compaction behavior.
 
 The editable **Supplemental summary prompt** starts with:
 
@@ -79,17 +79,20 @@ Keep the entire checkpoint, including all required headings, within a target of
 
 Keep `{target}` in your text—it is replaced with the calculated token target before each supported summary. The template can contain up to 2,048 characters. Use **Restore default prompt** to reset it, then **Save preferences** to apply your choice.
 
-Expand **Calculation and limits** for the additional ratios:
+Two divisors control the target (both default to **2**, or **50%**):
 
 | Divisor | Default | Limits the target to |
 |---|---:|---|
-| Context (N) | 16 | Context ÷ N |
-| Summary output (O) | 2 | Actual summary output cap ÷ O |
+| Output budget (O) | 2 | Estimated effective summary output budget ÷ O |
 | Source length (S) | 2 | Estimated content being summarized ÷ S |
 
-The target is the smallest result, rounded down. All divisors accept decimals of at least 1. Increasing a divisor lowers its bound; another bound may still determine the final target. Context uses the smaller verified server/client window, and the source estimate excludes system prompts and tool definitions.
+The target is the smaller result, rounded down. All divisors accept decimals of at least 1. There is no context divisor; a legacy `summaryContextDivisor` value is ignored. Existing output/source divisors and explicit enable choices are preserved. New or unspecified guidance remains **off**.
 
-With 32K context, a 4,096-token summary cap and enough source content, the defaults target **2,048 tokens**. This is a writing instruction, **not a hard output limit or a guarantee against truncation**. The UI previews a ceiling; the actual request may have a smaller target.
+The effective output budget is an **estimate**, not the raw requested `maxTokens` or a server-confirmed cap. It is the smaller of the request's summary cap and estimated remaining context. The latter uses the smaller verified server/client window, subtracts the full prompt (including system text, tool schemas and the supplement), and allows for the supported pi-ai adapter's 4,096-token safety reserve. Text is estimated at 3.5 characters/token with extra framing. The separate source estimate uses DSH's four-character heuristic and excludes the system prompt, tools and summary instruction. Neither estimate is an exact tokenizer count.
+
+For example, a 4,096-token effective output budget with enough source content gives a **2,048-token target** in either 32K or 64K context. A 2,000-token source instead gives a **1,000-token target**. Less remaining context can reduce the target further. The UI previews an upper bound from the proposed summary cap, before request-specific costs are known.
+
+This is a writing instruction, **not a hard output limit or a guarantee against truncation**. Reasoning may consume the same output budget; the plugin does not change reasoning, `maxTokens`, `fit_max_tokens` or compaction timing. The server's actual tokenizer, later middleware, or a different adapter version may impose a lower limit.
 
 Saving summary preferences does not change model budgets. Native prompt content is preserved, and no extra inference or retry loop is added. If the request cannot be verified or safely estimated, or the target is below 256 tokens, the original summary request proceeds unchanged.
 

package/dist/client.js

@@ -115,9 +115,9 @@ window.__ModuleLoader__.load({
     "zh-Hant": "啟用後，在每次支援的 Strata 摘要請求前，計算長度目標，並在 DSH 原生摘要提示詞後補充一句。",
     "zh-Hans": "启用后，在每次支持的 Strata 摘要请求前，计算长度目标，并在 DSH 原生摘要提示词后补充一句。"
   },
-  "Target = floor(min(context / N, summary output limit / O, selected content estimate / S)).": {
-    "zh-Hant": "目標 = floor(min(上下文 / N, 摘要輸出上限 / O, 待壓縮內容估算 / S))。",
-    "zh-Hans": "目标 = floor(min(上下文 / N, 摘要输出上限 / O, 待压缩内容估算 / S))。"
+  "Target = floor(min(estimated effective output budget / O, selected content estimate / S)). Default divisors: 2 and 2 (50% each).": {
+    "zh-Hant": "目標 = floor(min(估算有效輸出預算 / O, 待壓縮內容估算 / S))。兩個除數預設均為 2（各取 50%）。",
+    "zh-Hans": "目标 = floor(min(估算有效输出预算 / O, 待压缩内容估算 / S))。两个除数默认均为 2（各取 50%）。"
   },
   "When guidance cannot be applied, DSH keeps its native summary behavior.": {
     "zh-Hant": "無法套用時，沿用 DSH 原生摘要。",
@@ -127,25 +127,21 @@ window.__ModuleLoader__.load({
     "zh-Hant": "啟用摘要提示補充",
     "zh-Hans": "启用摘要提示补充"
   },
-  "Enabled by default. Turning this off keeps DSH's native summary and automatic compaction behavior.": {
-    "zh-Hant": "預設開啟。關閉後保留 DSH 原生摘要與自動壓縮行為。",
-    "zh-Hans": "默认开启。关闭后保留 DSH 原生摘要与自动压缩行为。"
+  "Off by default. Enable it to supplement DSH's native summary and automatic compaction behavior.": {
+    "zh-Hant": "預設關閉。啟用後補充 DSH 原生摘要提示詞。",
+    "zh-Hans": "默认关闭。启用后补充 DSH 原生摘要提示词。"
   },
-  "Context divisor (context ÷ N)": {
-    "zh-Hant": "上下文除數（上下文 ÷ N）",
-    "zh-Hans": "上下文除数（上下文 ÷ N）"
-  },
-  "Summary output divisor (output limit ÷ O)": {
-    "zh-Hant": "摘要輸出除數（輸出上限 ÷ O）",
-    "zh-Hans": "摘要输出除数（输出上限 ÷ O）"
+  "Output budget divisor (estimated budget ÷ O)": {
+    "zh-Hant": "摘要輸出除數（估算可用預算 ÷ O）",
+    "zh-Hans": "摘要输出除数（估算可用预算 ÷ O）"
   },
   "Source length divisor (source estimate ÷ S)": {
     "zh-Hant": "原文長度除數（原文估算 ÷ S）",
     "zh-Hans": "原文长度除数（原文估算 ÷ S）"
   },
-  "Defaults: N = 16, O = 2, S = 2. Smaller divisors allow longer targets; the smallest of the three bounds wins. Decimals are supported.": {
-    "zh-Hant": "預設 N = 16、O = 2、S = 2。除數越小，目標可越長；最後取三項限制的最小值。支援小數。",
-    "zh-Hans": "默认 N = 16、O = 2、S = 2。除数越小，目标可越长；最后取三项限制的最小值。支持小数。"
+  "Defaults: O = 2, S = 2 (50% each). Smaller divisors allow longer targets; the smaller of the two bounds wins. Decimals are supported.": {
+    "zh-Hant": "預設 O = 2、S = 2（各取 50%）。除數越小，目標可越長；最後取兩項限制的較小值。支援小數。",
+    "zh-Hans": "默认 O = 2、S = 2（各取 50%）。除数越小，目标可越长；最后取两项限制的较小值。支持小数。"
   },
   "Enter a finite divisor of at least 1; decimals are allowed.": {
     "zh-Hant": "請輸入大於或等於 1 的有限除數，可使用小數。",
@@ -163,9 +159,9 @@ window.__ModuleLoader__.load({
     "zh-Hant": "儲存偏好後，這些控制項會套用至後續摘要請求；其他模型與壓縮設定保持不變。",
     "zh-Hans": "保存偏好后，这些控制项将应用于后续摘要请求；其他模型与压缩设置保持不变。"
   },
-  "Context uses the smaller of the verified Strata window and the existing DSH model window. The preview ceiling assumes the proposed budgets; existing conversation settings can make the actual target lower.": {
-    "zh-Hant": "上下文採用已確認的 Strata 視窗與 DSH 既有模型視窗的較小值。預覽上限依提議預算計算，既有對話設定可能讓實際目標更低。",
-    "zh-Hans": "上下文采用已确认的 Strata 窗口与 DSH 已有模型窗口的较小值。预览上限按提议预算计算，已有对话设置可能让实际目标更低。"
+  "The preview uses the proposed summary cap. Actual targets also account for the estimated remaining context and source length; they may be lower.": {
+    "zh-Hant": "預覽採用提議的摘要上限。實際目標還會考慮估算的上下文剩餘空間與原文長度，可能更低。",
+    "zh-Hans": "预览采用提议的摘要上限。实际目标还会考虑估算的上下文剩余空间与原文长度，可能更低。"
   },
   "The original prompt, output cap and other settings stay unchanged. This is a writing target, not a guaranteed length or an optimal value.": {
     "zh-Hant": "保留原生提示詞、輸出硬上限與其他設定。這是寫作目標，不保證實際長度，也不代表最佳值。",
@@ -431,20 +427,20 @@ REASONING_DEFAULT_CONFLICT: 'The provider default reasoning level is not support
       };
       const diagnostic = (message) => translations[message] ? t(message) : language === 'en' ? message : t('Server diagnostic: ') + message;
       const [state,setState] = React.useState(null), [preview,setPreview] = React.useState(null), [result,setResult] = React.useState(null);
-      const [form,setForm] = React.useState({providerId:'',output:'',manual:false,auto:false,follow:true,summaryGuidance:true,summaryDivisor:'16',summaryOutputDivisor:'2',summarySourceDivisor:'2',summaryPrompt:''});
+      const [form,setForm] = React.useState({providerId:'',output:'',manual:false,auto:false,follow:true,summaryGuidance:false,summaryOutputDivisor:'2',summarySourceDivisor:'2',summaryPrompt:''});
       const [pending,setPending] = React.useState(false), [error,setError] = React.useState(''), [loadError,setLoadError] = React.useState('');
       const [notice,setNotice] = React.useState(''), [conflict,setConflict] = React.useState(false);
       const formRef=React.useRef(form), baseline=React.useRef(null), requestSeq=React.useRef(0), alive=React.useRef(true);
       const numberValue = value => value.trim()===''?NaN:Number(value);
-      const values = (f) => ({providerId:f.providerId,outputTokens:f.manual ? (f.output.trim()==='' ? NaN : Number(f.output)) : null,autoSync:f.auto,followLoadedModel:f.follow,summaryGuidance:f.summaryGuidance,summaryContextDivisor:numberValue(f.summaryDivisor),summaryOutputDivisor:numberValue(f.summaryOutputDivisor),summarySourceDivisor:numberValue(f.summarySourceDivisor),summaryPromptTemplate:f.summaryPrompt});
-      const preferences = (s) => ({providerId:s.providerId || '',outputTokens:s.outputTokens ?? null,autoSync:!!s.autoSync,followLoadedModel:s.followLoadedModel !== false,summaryGuidance:s.summaryGuidance!==false,summaryContextDivisor:s.summaryContextDivisor??16,summaryOutputDivisor:s.summaryOutputDivisor??2,summarySourceDivisor:s.summarySourceDivisor??2,summaryPromptTemplate:s.summaryPromptTemplate??s.defaultSummaryPromptTemplate??''});
+      const values = (f) => ({providerId:f.providerId,outputTokens:f.manual ? (f.output.trim()==='' ? NaN : Number(f.output)) : null,autoSync:f.auto,followLoadedModel:f.follow,summaryGuidance:f.summaryGuidance,summaryOutputDivisor:numberValue(f.summaryOutputDivisor),summarySourceDivisor:numberValue(f.summarySourceDivisor),summaryPromptTemplate:f.summaryPrompt});
+      const preferences = (s) => ({providerId:s.providerId || '',outputTokens:s.outputTokens ?? null,autoSync:!!s.autoSync,followLoadedModel:s.followLoadedModel !== false,summaryGuidance:s.summaryGuidance===true,summaryOutputDivisor:s.summaryOutputDivisor??2,summarySourceDivisor:s.summarySourceDivisor??2,summaryPromptTemplate:s.summaryPromptTemplate??s.defaultSummaryPromptTemplate??''});
       const equal = (a,b) => Object.keys(a).every(key=>Object.is(a[key],b[key]));
       const acceptStatus = React.useCallback((s,force=false) => {
         if (!alive.current) return;
         const next=preferences(s), old=baseline.current;
         const untouched=!old || equal(values(formRef.current),old.values);
         if (force || untouched) {
-          const nextForm={providerId:next.providerId,output:next.outputTokens==null?'':String(next.outputTokens),manual:next.outputTokens!=null,auto:next.autoSync,follow:next.followLoadedModel,summaryGuidance:next.summaryGuidance,summaryDivisor:String(next.summaryContextDivisor),summaryOutputDivisor:String(next.summaryOutputDivisor),summarySourceDivisor:String(next.summarySourceDivisor),summaryPrompt:next.summaryPromptTemplate};
+          const nextForm={providerId:next.providerId,output:next.outputTokens==null?'':String(next.outputTokens),manual:next.outputTokens!=null,auto:next.autoSync,follow:next.followLoadedModel,summaryGuidance:next.summaryGuidance,summaryOutputDivisor:String(next.summaryOutputDivisor),summarySourceDivisor:String(next.summarySourceDivisor),summaryPrompt:next.summaryPromptTemplate};
           formRef.current=nextForm; setForm(nextForm); setConflict(false);
           baseline.current={values:next,revision:s.settingsRevision};
         } else if (old.revision!==s.settingsRevision || !equal(old.values,next)) {
@@ -477,14 +473,14 @@ REASONING_DEFAULT_CONFLICT: 'The provider default reasoning level is not support
         } finally { if(alive.current)setPending(false); }
       }
       const draft=values(form), isDivisor=value=>Number.isFinite(value)&&value>=1&&value<=Number.MAX_SAFE_INTEGER;
-      const validDivisor=[draft.summaryContextDivisor,draft.summaryOutputDivisor,draft.summarySourceDivisor].every(isDivisor);
+      const validDivisor=[draft.summaryOutputDivisor,draft.summarySourceDivisor].every(isDivisor);
       const validPrompt=typeof draft.summaryPromptTemplate==='string'&&draft.summaryPromptTemplate.length>0&&draft.summaryPromptTemplate.length<=2048&&draft.summaryPromptTemplate.includes('{target}');
       const valid=validDivisor&&validPrompt&&(draft.outputTokens===null || Number.isSafeInteger(draft.outputTokens)&&draft.outputTokens>0);
       const dirty=!!baseline.current&&!equal(draft,baseline.current.values);
       const displayedResult=!result || state?.lastApplied?.at>result.at ? state?.lastApplied : result;
       const activeBudget=preview?.budget;
       const summaryTargetCeiling=form.summaryGuidance&&validDivisor&&Number.isSafeInteger(activeBudget?.contextWindow)&&activeBudget.contextWindow>0&&Number.isSafeInteger(activeBudget?.summaryMaxTokens)&&activeBudget.summaryMaxTokens>0
-        ? Math.floor(Math.min(activeBudget.contextWindow/draft.summaryContextDivisor,activeBudget.summaryMaxTokens/draft.summaryOutputDivisor)) : null;
+        ? Math.floor(activeBudget.summaryMaxTokens/draft.summaryOutputDivisor) : null;
       const outputSource=(budget)=>t(({server:'Strata Server default',manual:'Manual override',calculated:'Automatic calculation'})[budget?.outputSource]||'Automatic calculation');
       const preserved=(view)=>{
         const status=view?.capabilityStatus;
@@ -529,7 +525,9 @@ REASONING_DEFAULT_CONFLICT: 'The provider default reasoning level is not support
         h('div',{className:'ss-card','data-testid':'summary-target'},
           h('strong',null,t('Dynamic summary target')),
           h('label',{className:'ss-check'},h('input',{type:'checkbox','data-testid':'summary-guidance-toggle','aria-label':t('Enable summary guidance'),checked:form.summaryGuidance,onChange:e=>edit({summaryGuidance:e.target.checked}),disabled:pending||!state}),t('Enable summary guidance')),
-          h('label',null,t('Context divisor (context ÷ N)'),h('input',{type:'number','data-testid':'summary-divisor','aria-label':t('Context divisor (context ÷ N)'),'aria-invalid':!isDivisor(draft.summaryContextDivisor),min:1,max:Number.MAX_SAFE_INTEGER,step:'any',value:form.summaryDivisor,onChange:e=>edit({summaryDivisor:e.target.value}),disabled:pending||!state})),
+          h('div',{className:'ss-grid'},
+            h('label',null,t('Output budget divisor (estimated budget ÷ O)'),h('input',{type:'number','data-testid':'summary-output-divisor','aria-label':t('Output budget divisor (estimated budget ÷ O)'),'aria-invalid':!isDivisor(draft.summaryOutputDivisor),min:1,max:Number.MAX_SAFE_INTEGER,step:'any',value:form.summaryOutputDivisor,onChange:e=>edit({summaryOutputDivisor:e.target.value}),disabled:pending||!state})),
+            h('label',null,t('Source length divisor (source estimate ÷ S)'),h('input',{type:'number','data-testid':'summary-source-divisor','aria-label':t('Source length divisor (source estimate ÷ S)'),'aria-invalid':!isDivisor(draft.summarySourceDivisor),min:1,max:Number.MAX_SAFE_INTEGER,step:'any',value:form.summarySourceDivisor,onChange:e=>edit({summarySourceDivisor:e.target.value}),disabled:pending||!state}))),
           state&&!validDivisor&&h('p',{className:'ss-status ss-error',role:'alert'},t('Enter a finite divisor of at least 1; decimals are allowed.')),
           h('label',{className:'ss-prompt-label'},t('Supplemental summary prompt'),h('textarea',{'data-testid':'summary-prompt','aria-label':t('Supplemental summary prompt'),'aria-invalid':!validPrompt,rows:5,value:form.summaryPrompt,onChange:e=>edit({summaryPrompt:e.target.value}),disabled:pending||!state,spellCheck:false})),
           state&&!validPrompt&&h('p',{className:'ss-status ss-error',role:'alert'},t('Use 1–2,048 characters and include {target}.')),
@@ -540,11 +538,8 @@ REASONING_DEFAULT_CONFLICT: 'The provider default reasoning level is not support
             ? h('p',{'data-testid':'summary-target-ceiling'},t('Maximum target for this preview: '),format(summaryTargetCeiling),' tokens')
             : h('p',{className:'ss-status','data-testid':'summary-target-native'},t('This preview is below the 256-token minimum. The native summary prompt remains unchanged.'))),
           h('details',{className:'ss-details','data-testid':'summary-details'},h('summary',null,t('Calculation and limits')),
-            h('div',{className:'ss-grid'},
-              h('label',null,t('Summary output divisor (output limit ÷ O)'),h('input',{type:'number','data-testid':'summary-output-divisor','aria-label':t('Summary output divisor (output limit ÷ O)'),'aria-invalid':!isDivisor(draft.summaryOutputDivisor),min:1,max:Number.MAX_SAFE_INTEGER,step:'any',value:form.summaryOutputDivisor,onChange:e=>edit({summaryOutputDivisor:e.target.value}),disabled:pending||!state})),
-              h('label',null,t('Source length divisor (source estimate ÷ S)'),h('input',{type:'number','data-testid':'summary-source-divisor','aria-label':t('Source length divisor (source estimate ÷ S)'),'aria-invalid':!isDivisor(draft.summarySourceDivisor),min:1,max:Number.MAX_SAFE_INTEGER,step:'any',value:form.summarySourceDivisor,onChange:e=>edit({summarySourceDivisor:e.target.value}),disabled:pending||!state}))),
-            h('p',{className:'ss-muted'},t('Target = floor(min(context / N, summary output limit / O, selected content estimate / S)).')),
-            h('p',{className:'ss-muted'},t('When guidance cannot be applied, DSH keeps its native summary behavior.')))),
+            h('p',{className:'ss-muted'},t('Target = floor(min(estimated effective output budget / O, selected content estimate / S)). Default divisors: 2 and 2 (50% each).')),
+            h('p',{className:'ss-muted'},t('The preview uses the proposed summary cap. Actual targets also account for the estimated remaining context and source length; they may be lower.'),' ',t('When guidance cannot be applied, DSH keeps its native summary behavior.')))),
         h('div',{className:'ss-actions'},
           h('button',{disabled:pending||!state||!form.providerId||!valid||!dirty||conflict,onClick:()=>action(async()=>{
             const changes=Object.fromEntries(Object.entries(values(formRef.current)).filter(([key,value])=>!Object.is(value,baseline.current.values[key])));

package/dist/index.js

@@ -3,7 +3,7 @@ import { mkdir, readFile, writeFile } from 'node:fs/promises';
 import { dirname, join } from 'node:path';
 import z from '@deepseek-ai/schemastery';
 import { discoverStrata, planBudget, StrataSyncError } from './core.mjs';
-import { DEFAULT_SUMMARY_DIVISOR, DEFAULT_SUMMARY_TEMPLATE, validSummaryDivisor, validSummaryTemplate, installSummaryGuidance } from './summary.mjs';
+import { DEFAULT_SUMMARY_TEMPLATE, validSummaryDivisor, validSummaryTemplate, installSummaryGuidance } from './summary.mjs';
 
 export const inject = ['configEditor', 'connection', 'agents', 'credentials', 'agentPresets'];
 export const Config = z.object({
@@ -11,8 +11,7 @@ export const Config = z.object({
   autoSync: z.boolean().default(false),
   followLoadedModel: z.boolean().default(true),
   outputTokens: z.number().step(1).min(1),
-  summaryGuidance: z.boolean().default(true),
-  summaryContextDivisor: z.number().min(1).max(Number.MAX_SAFE_INTEGER).default(DEFAULT_SUMMARY_DIVISOR),
+  summaryGuidance: z.boolean().default(false),
   summaryOutputDivisor: z.number().min(1).max(Number.MAX_SAFE_INTEGER).default(2),
   summarySourceDivisor: z.number().min(1).max(Number.MAX_SAFE_INTEGER).default(2),
   summaryPromptTemplate: z.string().default(DEFAULT_SUMMARY_TEMPLATE),
@@ -145,7 +144,7 @@ export function apply(ctx, initialConfig) {
   function publicSettings(value = settings) {
     return { providerId: value.providerId ?? '', autoSync: value.autoSync ?? false,
       followLoadedModel: value.followLoadedModel ?? true, outputTokens: value.outputTokens ?? null,
-      summaryGuidance: value.summaryGuidance ?? true, summaryContextDivisor: value.summaryContextDivisor ?? DEFAULT_SUMMARY_DIVISOR,
+      summaryGuidance: value.summaryGuidance ?? false,
       summaryOutputDivisor: value.summaryOutputDivisor ?? 2, summarySourceDivisor: value.summarySourceDivisor ?? 2,
       summaryPromptTemplate: value.summaryPromptTemplate ?? DEFAULT_SUMMARY_TEMPLATE };
   }
@@ -389,7 +388,7 @@ export function apply(ctx, initialConfig) {
   }
   async function configure(request) {
     ensureOpen();
-    payload(request, ['providerId', 'autoSync', 'followLoadedModel', 'outputTokens', 'summaryGuidance', 'summaryContextDivisor', 'summaryOutputDivisor', 'summarySourceDivisor', 'summaryPromptTemplate', 'expectedRevision']);
+    payload(request, ['providerId', 'autoSync', 'followLoadedModel', 'outputTokens', 'summaryGuidance', 'summaryOutputDivisor', 'summarySourceDivisor', 'summaryPromptTemplate', 'expectedRevision']);
     refreshSettings();
     if (typeof request.expectedRevision !== 'string' || request.expectedRevision !== hash(publicSettings())) {
       refuse('stale-settings', 'Sync preferences changed. Reload the latest preferences before saving.');
@@ -405,7 +404,7 @@ export function apply(ctx, initialConfig) {
       if (typeof request[key] !== 'boolean') refuse('invalid-request', `${key} must be a boolean.`);
       next[key] = request[key];
     }
-    for (const key of ['summaryContextDivisor', 'summaryOutputDivisor', 'summarySourceDivisor']) {
+    for (const key of ['summaryOutputDivisor', 'summarySourceDivisor']) {
       if (!own(request, key)) continue;
       if (!validSummaryDivisor(request[key])) refuse('invalid-budget', 'Summary divisors must be finite numbers from 1 to Number.MAX_SAFE_INTEGER.');
       next[key] = request[key];

package/dist/summary.mjs

@@ -12,11 +12,9 @@ const augmentedMessages = globalThis[Symbol.for('dsh-strata-sync/summary-augment
 // Eight mandatory headings need enough space for a meaningful checkpoint. Do
 // not round a tiny target UP; leave native behavior intact instead.
 export const MIN_SUMMARY_TARGET = 256;
-export const DEFAULT_SUMMARY_DIVISOR = 16;
-
-export function planSummaryTarget(contextWindow, summaryMaxTokens, sourceTokens, divisor = DEFAULT_SUMMARY_DIVISOR, outputDivisor = 2, sourceDivisor = 2) {
-  if (![contextWindow, summaryMaxTokens, sourceTokens].every(positive) || ![divisor, outputDivisor, sourceDivisor].every(validSummaryDivisor)) return null;
-  const target = Math.floor(Math.min(contextWindow / divisor, summaryMaxTokens / outputDivisor, sourceTokens / sourceDivisor));
+export function planSummaryTarget(effectiveOutputTokens, sourceTokens, outputDivisor = 2, sourceDivisor = 2) {
+  if (![effectiveOutputTokens, sourceTokens].every(positive) || ![outputDivisor, sourceDivisor].every(validSummaryDivisor)) return null;
+  const target = Math.floor(Math.min(effectiveOutputTokens / outputDivisor, sourceTokens / sourceDivisor));
   return target >= MIN_SUMMARY_TARGET ? target : null;
 }
 
@@ -68,6 +66,47 @@ export function estimateSummarySource(messages) {
   return positive(tokens) ? tokens : null;
 }
 
+/** Conservative text-only estimate of the output room before provider dispatch.
+ * The supported DSH adapter uses pi-ai 1.1.0: 3.5 chars/token and
+ * reserves 4096 tokens before clamping maxTokens. Replayed assistant usage is
+ * zeroed by DSH. Include system text, tool schemas and framing as well, even
+ * where that adapter's heuristic omits them. This is NOT a tokenizer count or
+ * the server's final cap; unknown content leaves the native prompt untouched.
+ */
+export function estimateEffectiveSummaryBudget(options, contextWindow, template = DEFAULT_SUMMARY_TEMPLATE) {
+  if (!positive(contextWindow) || !positive(options?.maxTokens) || !validSummaryTemplate(template) || !Array.isArray(options.messages)) return null;
+  const price = text => Math.ceil(text.length / 3.5) + 4;
+  let input = 0;
+  try {
+    if (options.system !== undefined) {
+      if (typeof options.system !== 'string') return null;
+      input += price(options.system);
+    }
+    if (options.tools !== undefined) {
+      if (!Array.isArray(options.tools)) return null;
+      input += price(JSON.stringify(options.tools));
+    }
+    for (const message of options.messages) {
+      if (!['system', 'user', 'assistant', 'tool'].includes(message?.role) || !Array.isArray(message.content)) return null;
+      input += 4;
+      if (message.role === 'tool' && !message.content.some(block => block.type === 'text' && block.text?.length)) input += price('(no output)');
+      for (const block of message.content) {
+        if (['text', 'reasoning'].includes(block?.type) && typeof block.text === 'string') input += price(block.text);
+        else if (block?.type === 'tool-call' && typeof block.name === 'string' && typeof block.arguments === 'string') {
+          // JSON normalization can expand compact numeric literals (e.g. 1e9).
+          const normalized = JSON.stringify(JSON.parse(block.arguments));
+          input += price(block.name) + Math.max(price(block.arguments), price(normalized));
+        } else return null;
+      }
+    }
+    // Reserve the longest possible rendered supplement once, avoiding a
+    // self-referential target calculation. The target never exceeds maxTokens.
+    input += price('\n- ' + summaryInstruction(options.maxTokens, template));
+  } catch { return null; }
+  if (!Number.isSafeInteger(input)) return null;
+  return Math.max(0, Math.min(options.maxTokens, contextWindow - input - 4096));
+}
+
 /** The native waterfall's next() closes over options, so replace only its
  * messages property for the lifetime of this stream; never mutate frozen
  * messages or recursively dispatch a second LLM request.
@@ -77,13 +116,12 @@ export function installSummaryGuidance(ctx, resolveContext, getSettings = () =>
   function preferences() {
     try {
       const value = getSettings();
-      const enabled = value.summaryGuidance === undefined ? true : value.summaryGuidance;
-      const divisor = value.summaryContextDivisor === undefined ? DEFAULT_SUMMARY_DIVISOR : value.summaryContextDivisor;
+      const enabled = value.summaryGuidance === undefined ? false : value.summaryGuidance;
       const outputDivisor = value.summaryOutputDivisor === undefined ? 2 : value.summaryOutputDivisor;
       const sourceDivisor = value.summarySourceDivisor === undefined ? 2 : value.summarySourceDivisor;
       const template = value.summaryPromptTemplate === undefined ? DEFAULT_SUMMARY_TEMPLATE : value.summaryPromptTemplate;
-      return enabled === true && [divisor, outputDivisor, sourceDivisor].every(validSummaryDivisor) && validSummaryTemplate(template)
-        ? { divisor, outputDivisor, sourceDivisor, template } : null;
+      return enabled === true && [outputDivisor, sourceDivisor].every(validSummaryDivisor) && validSummaryTemplate(template)
+        ? { outputDivisor, sourceDivisor, template } : null;
     } catch { return null; }
   }
   const remove = ctx.on('llm/stream', (options, next) => {
@@ -103,7 +141,8 @@ export function installSummaryGuidance(ctx, resolveContext, getSettings = () =>
         let contextWindow;
         try { contextWindow = await resolveContext(options); }
         catch { /* Metadata/compatibility failure must not break native inference. */ }
-        const target = planSummaryTarget(contextWindow, options.maxTokens, sourceTokens, selected.divisor, selected.outputDivisor, selected.sourceDivisor);
+        const effectiveOutput = estimateEffectiveSummaryBudget(options, contextWindow, selected.template);
+        const target = planSummaryTarget(effectiveOutput, sourceTokens, selected.outputDivisor, selected.sourceDivisor);
         const current = preferences();
         if (!closed && !options.signal?.aborted && current && Object.keys(selected).every(key => selected[key] === current[key]) && target !== null && options.messages === original) {
           const last = { ...native, content: [{ ...native.content[0], text: `${native.content[0].text}\n- ${summaryInstruction(target, selected.template)}` }] };

package/docs/README.zh-CN.md

@@ -69,7 +69,7 @@ dsh plugin --profile desktop add dsh-strata-sync --registry=https://registry.npm
 
 ## 摘要提示词与目标长度
 
-**动态摘要目标**默认开启，在 DSH 原生摘要指令后补充要求；关闭后仍保留原生摘要与压缩行为。
+**动态摘要目标**默认关闭。启用后会在 DSH 原生摘要指令后补充要求；关闭时使用 DSH 原生摘要与压缩行为。
 
 可编辑的**摘要补充提示词**默认内容为：
 
@@ -79,17 +79,20 @@ Keep the entire checkpoint, including all required headings, within a target of
 
 请保留 `{target}`，每次支持的摘要请求前，它会替换成计算出的 token 目标。模板最多 2,048 个字符。点击**恢复默认提示词**可重置内容，再点击**保存偏好**应用修改。
 
-展开**计算方式与限制**，可以调整其余比例：
+两个除数控制目标，默认均为 **2（各取 50%）**：
 
 | 除数 | 默认值 | 将目标限制为 |
 |---|---:|---|
-| 上下文（N） | 16 | 上下文 ÷ N |
-| 摘要输出（O） | 2 | 本次摘要实际输出上限 ÷ O |
+| 摘要输出（O） | 2 | 估算有效摘要输出预算 ÷ O |
 | 原文长度（S） | 2 | 待摘要内容的估算长度 ÷ S |
 
-目标取三项结果的最小值，再向下取整。所有除数均支持大于或等于 1 的小数。增加除数会降低对应上限，但最终目标仍可能由另一项上限决定。上下文取已确认的服务器与客户端窗口中较小者，原文估算不包含系统提示词和工具定义。
+目标取两项结果的较小值，再向下取整。除数支持大于或等于 1 的小数。已移除上下文除数；旧设置中的 `summaryContextDivisor` 不再参与计算。已有输出／原文除数及明确的启用选择会保留，新安装或未指定时仍**默认关闭**。
 
-32K 上下文、摘要上限为 4,096 tokens 且原文足够长时，默认目标为 **2,048 tokens**。这是写作指令，**不是输出硬上限，也不能保证不截断**。界面预览的是目标上限，实际请求的目标可能更小。
+有效输出预算是**估算值**，不是直接把请求的 `maxTokens` 当作服务器确认的上限。它取本次摘要输出上限与估算上下文剩余空间中的较小值；后者使用已确认的服务器／客户端窗口较小值，扣除完整提示内容（包含系统提示、工具定义和补充句），再预留支持的 pi-ai 适配器所用的 4,096 tokens 安全空间。文本以每 token 约 3.5 字符并加上格式成本估算。原文长度另采用 DSH 的每 token 约 4 字符估算，不含系统提示、工具和摘要指令。两者都不是精确 tokenizer 计数。
+
+例如，有效输出预算为 4,096 tokens 且原文足够长时，32K 与 64K 上下文的目标都是 **2,048 tokens**；原文只有约 2,000 tokens 时，目标为 **1,000 tokens**。上下文剩余空间不足时，目标会进一步降低。界面仅以提议的摘要上限预览目标上界，尚未扣除个别请求的成本。
+
+这是写作指令，**不是输出硬上限，也不能保证不截断**。思考可能共用输出预算；插件不会修改思考设置、`maxTokens`、`fit_max_tokens` 或压缩时机。服务器实际 tokenizer、后续中间层或不同适配器版本仍可能产生更低的上限。
 
 保存摘要偏好不会改变模型预算，也不会替换原生提示词或增加额外推理、重试循环。无法验证请求、无法安全估算内容，或目标小于 256 tokens 时，会沿用原本的摘要请求。
 

package/docs/README.zh-TW.md

@@ -69,7 +69,7 @@ dsh plugin --profile desktop add dsh-strata-sync --registry=https://registry.npm
 
 ## 摘要提示詞與目標長度
 
-**動態摘要目標**預設開啟，在 DSH 原生摘要指令後補充要求；關閉後仍保留原生摘要與壓縮行為。
+**動態摘要目標**預設關閉。啟用後會在 DSH 原生摘要指令後補充要求；關閉時使用 DSH 原生摘要與壓縮行為。
 
 可編輯的**摘要補充提示詞**預設內容為：
 
@@ -79,17 +79,20 @@ Keep the entire checkpoint, including all required headings, within a target of
 
 請保留 `{target}`，每次支援的摘要請求前，它會替換成計算出的 token 目標。範本最多 2,048 個字元。點選**還原預設提示詞**可重設內容，再點選**儲存偏好**套用修改。
 
-展開**計算方式與限制**，可以調整其餘比例：
+兩個除數控制目標，預設均為 **2（各取 50%）**：
 
 | 除數 | 預設值 | 將目標限制為 |
 |---|---:|---|
-| 上下文（N） | 16 | 上下文 ÷ N |
-| 摘要輸出（O） | 2 | 本次摘要實際輸出上限 ÷ O |
+| 摘要輸出（O） | 2 | 估算有效摘要輸出預算 ÷ O |
 | 原文長度（S） | 2 | 待摘要內容的估算長度 ÷ S |
 
-目標取三項結果的最小值，再向下取整。所有除數均支援大於或等於 1 的小數。增加除數會降低對應上限，但最終目標仍可能由另一項上限決定。上下文取已確認的伺服器與客戶端視窗中較小者，原文估算不包含系統提示詞和工具定義。
+目標取兩項結果的較小值，再向下取整。除數支援大於或等於 1 的小數。已移除上下文除數；舊設定中的 `summaryContextDivisor` 不再參與計算。既有輸出／原文除數及明確的啟用選擇會保留，新安裝或未指定時仍**預設關閉**。
 
-32K 上下文、摘要上限為 4,096 tokens 且原文足夠長時，預設目標為 **2,048 tokens**。這是寫作指令，**不是輸出硬上限，也不能保證不截斷**。介面預覽的是目標上限，實際請求的目標可能更小。
+有效輸出預算是**估算值**，不是直接把請求的 `maxTokens` 當作伺服器確認的上限。它取本次摘要輸出上限與估算上下文剩餘空間中的較小值；後者使用已確認的伺服器／客戶端視窗較小值，扣除完整提示內容（包含系統提示、工具定義和補充句），再預留支援的 pi-ai 轉接器所用的 4,096 tokens 安全空間。文字以每 token 約 3.5 字元並加上格式成本估算。原文長度另採 DSH 的每 token 約 4 字元估算，不含系統提示、工具和摘要指令。兩者都不是精確 tokenizer 計數。
+
+例如，有效輸出預算為 4,096 tokens 且原文足夠長時，32K 與 64K 上下文的目標都是 **2,048 tokens**；原文只有約 2,000 tokens 時，目標為 **1,000 tokens**。上下文剩餘空間不足時，目標會進一步降低。介面僅以提議的摘要上限預覽目標上界，尚未扣除個別請求的成本。
+
+這是寫作指令，**不是輸出硬上限，也不能保證不截斷**。思考可能共用輸出預算；外掛不會修改思考設定、`maxTokens`、`fit_max_tokens` 或壓縮時機。伺服器實際 tokenizer、後續中介層或不同轉接器版本仍可能產生更低的上限。
 
 儲存摘要偏好不會改變模型預算，也不會替換原生提示詞或增加額外推論、重試循環。無法驗證請求、無法安全估算內容，或目標小於 256 tokens 時，會沿用原本的摘要請求。
 

package/docs/VALIDATION.md

@@ -2,6 +2,20 @@
 
 Validation date: 2026-10-30 (Asia/Taipei).
 
+## Two-bound summary target 0.10.4
+
+- The target uses only estimated effective output budget / output divisor and selected-source estimate / source divisor. Both divisors default to 2 (50%). The context-divisor control and formula term are removed; legacy stored context divisors are ignored without enabling guidance.
+- Guidance remains off by default in schema, host fallback, request middleware and all three UI locales. Explicit enable choices, output/source divisors and editable templates remain supported. No production settings were edited. Installing the release is left to the user.
+- Effective output room is estimated conservatively against the supported pi-ai 1.1.0 context clamp, including the supplement, system text and tools. It is not a server tokenizer result. Reasoning and later request transformations can still reduce usable answer space.
+- All **155 automated tests pass**. Tests cover the actual pi-ai clamp on multiple context/input sizes, near-full and exhausted context, independent source length, additional prompt costs, ignored legacy divisors, disabled-mode zero discovery, restored native requests and localized controls. The package verifier also passes.
+- No model inference requests were sent. Tests do not prove truncation is impossible; this supplement is a writing target and leaves native hard caps, reasoning and server configuration unchanged.
+
+## Earlier opt-in summary validation (before the two-bound update)
+
+- Summary guidance now defaults to `false` in the schema, host fallback, request hook and UI. An existing explicit `true` remains enabled; all other budgets and summary parameters are preserved.
+- Added a three-language UI regression for an omitted preference. Host and middleware tests verify that omitted/disabled guidance preserves native requests and makes no metadata calls; explicit opt-in still appends the configured sentence.
+- All 152 automated tests pass, including 39 UI tests and the package verifier. No inference requests were sent.
+
 ## Concise summary help 0.10.1
 
 - Reduces the expanded summary help to the calculation formula and one native-fallback sentence in all three locales. Full explanations remain in the READMEs. No runtime behavior, settings, defaults or prompt text changes.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-strata-sync",
-  "version": "0.10.3",
+  "version": "0.10.4",
   "description": "Native DSH settings UI for synchronizing Strata Server models, context and compaction budgets",
   "type": "module",
   "main": "dist/index.js",