@jetcrab/pi-desk-ctx 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,3 +1,5 @@
-# Temporary Holding Version
+# Pi Desk — pi-desk-ctx
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+包名：`@jetcrab/pi-desk-ctx`。插件接口以源码导出为准，个人配置不随包分发。
+
+许可与第三方来源见本目录的 LICENSE 及适用的归属说明。

package/dist/auto-compaction.d.ts

@@ -0,0 +1,21 @@
+import type { CompactionResult } from '@earendil-works/pi-coding-agent';
+import type { AutoIgnoreDecision } from './auto-ignore.js';
+export declare const CONTEXT_IGNORE_RETRY_SUMMARY = "\u5DF2\u901A\u8FC7\u4E0A\u4E0B\u6587\u5FFD\u7565\u964D\u4F4E\u65E7\u8FC7\u7A0B\u4FE1\u606F\uFF1B\u672C\u68C0\u67E5\u70B9\u672A\u751F\u6210\u4F1A\u8BDD\u6458\u8981\u3002";
+export interface ContextIgnoreRetryDetails {
+    contextIgnoreRetry: true;
+    ignoredTokens: number;
+    reasoningReplayTokens: number;
+    providerIgnoredTokens: number;
+}
+export type AutoCompactionReason = 'manual' | 'threshold' | 'overflow';
+export type AutoCompactionIgnoreAction = {
+    type: 'none';
+} | {
+    type: 'compact';
+} | {
+    type: 'cancel';
+} | {
+    type: 'retry';
+    compaction: CompactionResult<ContextIgnoreRetryDetails>;
+};
+export declare function resolveAutoCompactionIgnoreAction(reason: AutoCompactionReason, willRetry: boolean, decision: AutoIgnoreDecision, firstActiveEntryId: string | undefined, contextTokens: number, contextWindow: number, reserveTokens: number): AutoCompactionIgnoreAction;

package/dist/auto-compaction.js

@@ -0,0 +1,31 @@
+export const CONTEXT_IGNORE_RETRY_SUMMARY = '已通过上下文忽略降低旧过程信息；本检查点未生成会话摘要。';
+export function resolveAutoCompactionIgnoreAction(reason, willRetry, decision, firstActiveEntryId, contextTokens, contextWindow, reserveTokens) {
+    if (reason === 'manual' || !decision.shouldIgnore || decision.cutoffTimestamp === undefined) {
+        return { type: 'none' };
+    }
+    const projectedContextTokens = Math.max(0, contextTokens - decision.potential.providerNetTokens);
+    const compactionThreshold = Math.max(0, contextWindow - reserveTokens);
+    if (contextWindow <= 0 || projectedContextTokens > compactionThreshold) {
+        return { type: 'compact' };
+    }
+    if (reason === 'threshold' || !willRetry) {
+        return { type: 'cancel' };
+    }
+    if (firstActiveEntryId === undefined) {
+        return { type: 'compact' };
+    }
+    return {
+        type: 'retry',
+        compaction: {
+            summary: CONTEXT_IGNORE_RETRY_SUMMARY,
+            firstKeptEntryId: firstActiveEntryId,
+            tokensBefore: Math.max(0, contextTokens),
+            details: {
+                contextIgnoreRetry: true,
+                ignoredTokens: decision.potential.netTokens,
+                reasoningReplayTokens: decision.potential.reasoningReplayTokens,
+                providerIgnoredTokens: decision.potential.providerNetTokens
+            }
+        }
+    };
+}

package/dist/auto-ignore.d.ts

@@ -0,0 +1,9 @@
+import type { ContextIgnorePotential, ContextIgnoreState } from './types.js';
+export interface AutoIgnoreDecision {
+    shouldIgnore: boolean;
+    cutoffTimestamp?: number;
+    nextState?: ContextIgnoreState;
+    potential: ContextIgnorePotential;
+    matchedRuleIndex?: number;
+}
+export declare function emptyContextIgnorePotential(): ContextIgnorePotential;

package/dist/auto-ignore.js

@@ -0,0 +1,7 @@
+export function emptyContextIgnorePotential() {
+    return {
+        reasoningReplayTokens: 0,
+        netTokens: 0,
+        providerNetTokens: 0
+    };
+}

package/dist/browser/chunks/browser-DJVEFCDQ.js

@@ -0,0 +1,72 @@
+import{createRoot as $e}from"react-dom/client";import{PluginErrorBoundary as Be}from"@jetcrab/pi-desk-sdk/react/base";import{Fragment as be,useId as re,useRef as ve}from"react";import{PluginActionRow as j,PluginAlert as he,PluginButton as T,PluginCheckbox as D,PluginConfirmDialog as ye,PluginInput as Te,PluginLoadingState as Ce,PluginPanelHeader as Pe,PluginScroll as we,PluginSection as ne,PluginSurface as Se,PluginTab as Ee,PluginTabList as Re}from"@jetcrab/pi-desk-sdk/react/base";import{useCallback as q,useEffect as L,useMemo as V,useRef as Y,useState as x}from"react";var pe={enabled:!0,profiles:[{maxContextTokens:4e5,checkpointTokens:32e4,keepRecentUserTurns:3,processTokenBudget:3e4,rules:[{currentTokensAtLeast:28e4,projectedTokensAtMost:5e4}]},{maxContextTokens:6e5,checkpointTokens:48e4,keepRecentUserTurns:3,processTokenBudget:4e4,rules:[{currentTokensAtLeast:4e5,projectedTokensAtMost:5e4},{currentTokensAtLeast:5e5,projectedTokensAtMost:1e5}]},{checkpointTokens:8e5,keepRecentUserTurns:3,processTokenBudget:4e4,rules:[{currentTokensAtLeast:8e5,projectedTokensAtMost:15e4}]}]},H=20,J=50,X=1e8,me=100;function B(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function $(e,r,n,t){if(!Number.isInteger(e)||e<n||e>t)throw new Error(`${r} \u5FC5\u987B\u662F ${n} \u5230 ${t} \u7684\u6574\u6570`);return e}function R(e,r){if(e!=null)return $(e,r,0,X)}function fe(e,r){if(!B(e))throw new Error(`${r} \u5FC5\u987B\u662F\u5BF9\u8C61`);let n=R(e.currentTokensAtLeast,`${r}.currentTokensAtLeast`),t=R(e.projectedTokensAtMost,`${r}.projectedTokensAtMost`);if(n===void 0&&t===void 0)throw new Error(`${r} \u81F3\u5C11\u9700\u8981\u4E00\u4E2A\u5224\u65AD\u6761\u4EF6`);return{...n===void 0?{}:{currentTokensAtLeast:n},...t===void 0?{}:{projectedTokensAtMost:t}}}function ge(e,r){let n=`profiles.${r}`;if(!B(e))throw new Error(`${n} \u5FC5\u987B\u662F\u5BF9\u8C61`);let t=R(e.maxContextTokens,`${n}.maxContextTokens`);if(t!==void 0&&t===0)throw new Error(`${n}.maxContextTokens \u5FC5\u987B\u5927\u4E8E 0`);let s=R(e.checkpointTokens,`${n}.checkpointTokens`);if(s!==void 0&&s===0)throw new Error(`${n}.checkpointTokens \u5FC5\u987B\u5927\u4E8E 0`);let i=$(e.keepRecentUserTurns,`${n}.keepRecentUserTurns`,1,me),o=$(e.processTokenBudget,`${n}.processTokenBudget`,0,X);if(!Array.isArray(e.rules)||e.rules.length>J)throw new Error(`${n}.rules \u5FC5\u987B\u662F\u6700\u591A ${J} \u6761\u89C4\u5219\u7684\u6570\u7EC4`);return{...t===void 0?{}:{maxContextTokens:t},...s===void 0?{}:{checkpointTokens:s},keepRecentUserTurns:i,processTokenBudget:o,rules:e.rules.map((l,m)=>fe(l,`${n}.rules.${m}`))}}function G(e){let r=e.profiles.map(n=>({...n.maxContextTokens===void 0?{}:{maxContextTokens:n.maxContextTokens},...n.checkpointTokens===void 0?{}:{checkpointTokens:n.checkpointTokens},keepRecentUserTurns:n.keepRecentUserTurns,processTokenBudget:n.processTokenBudget,rules:n.rules.map(t=>({...t}))})).sort((n,t)=>n.maxContextTokens===void 0?1:t.maxContextTokens===void 0?-1:n.maxContextTokens-t.maxContextTokens);return{enabled:e.enabled,profiles:r}}function K(e){if(!B(e))throw new Error("\u4E0A\u4E0B\u6587\u5FFD\u7565\u914D\u7F6E\u5FC5\u987B\u662F\u5BF9\u8C61");if(typeof e.enabled!="boolean")throw new Error("enabled \u5FC5\u987B\u662F\u5E03\u5C14\u503C");if(!Array.isArray(e.profiles)||e.profiles.length===0||e.profiles.length>H)throw new Error(`profiles \u5FC5\u987B\u5305\u542B 1 \u5230 ${H} \u4E2A\u6A21\u578B\u914D\u7F6E`);let r=e.profiles.map(ge);if(r.filter(s=>s.maxContextTokens===void 0).length!==1)throw new Error("\u5FC5\u987B\u4E14\u53EA\u80FD\u6709\u4E00\u4E2A\u4E0D\u9650\u5236\u6A21\u578B\u7A97\u53E3\u7684\u901A\u7528\u914D\u7F6E");let t=r.map(s=>s.maxContextTokens).filter(s=>s!==void 0);if(new Set(t).size!==t.length)throw new Error("\u6A21\u578B\u7A97\u53E3\u4E0A\u9650\u4E0D\u80FD\u91CD\u590D");return G({enabled:e.enabled,profiles:r})}function A(){return G(pe)}var P=class extends Error{constructor(n){super(n.message);this.issue=n}},Q=0;function ee(e){return Q+=1,{key:Q,maxContextK:e.maxContextTokens===void 0?null:String(e.maxContextTokens/1e3),checkpointEnabled:e.checkpointTokens!==void 0,checkpointK:e.checkpointTokens===void 0?"":String(e.checkpointTokens/1e3),keepRecentUserTurns:String(e.keepRecentUserTurns),processBudgetK:String(e.processTokenBudget/1e3),rules:e.rules.map(r=>({currentEnabled:r.currentTokensAtLeast!==void 0,currentK:r.currentTokensAtLeast===void 0?"":String(r.currentTokensAtLeast/1e3),projectedEnabled:r.projectedTokensAtMost!==void 0,projectedK:r.projectedTokensAtMost===void 0?"":String(r.projectedTokensAtMost/1e3)}))}}function _(e){return{enabled:e.enabled,profiles:e.profiles.map(ee)}}function ke(e,r,n,t,s,i,o){let l=Number(e),m=Math.round(l*t);if(e.trim()===""||!Number.isInteger(m)||m/t!==l||m<r||m>n)throw new P({profileKey:s,field:i,message:`${o}\u9700\u4E3A ${r/t}\u2013${n/t}${t===1e3?"k":" \u8F6E"}`});return m}function xe(e){let r=new Set,n=e.profiles.map(t=>{let s=(o,l,m,f=0,k=1e8,g=1e3)=>ke(o,f,k,g,t.key,l,m),i=t.maxContextK===null?void 0:s(t.maxContextK,"maxContextK","\u6A21\u578B\u5BB9\u91CF\u4E0A\u9650",1);if(i!==void 0){if(r.has(i))throw new P({profileKey:t.key,field:"maxContextK",message:"\u8FD9\u4E2A\u6A21\u578B\u5BB9\u91CF\u4E0A\u9650\u5DF2\u5B58\u5728"});r.add(i)}return{...i===void 0?{}:{maxContextTokens:i},...t.checkpointEnabled?{checkpointTokens:s(t.checkpointK,"checkpointK","\u8BB0\u5F55\u8FDB\u5C55\u7528\u91CF",1)}:{},keepRecentUserTurns:s(t.keepRecentUserTurns,"keepRecentUserTurns","\u6700\u8FD1\u5BF9\u8BDD\u8F6E\u6570",1,100,1),processTokenBudget:s(t.processBudgetK,"processBudgetK","\u8FC7\u7A0B\u7528\u91CF\u4E0A\u9650"),rules:t.rules.map((o,l)=>{if(!o.currentEnabled&&!o.projectedEnabled)throw new P({profileKey:t.key,field:`rule-${l}`,message:"\u8BF7\u81F3\u5C11\u9009\u62E9\u4E00\u4E2A\u6761\u4EF6"});return{...o.currentEnabled?{currentTokensAtLeast:s(o.currentK,`current-${l}`,"\u5F53\u524D\u7528\u91CF")}:{},...o.projectedEnabled?{projectedTokensAtMost:s(o.projectedK,`projected-${l}`,"\u5FFD\u7565\u540E\u9884\u8BA1\u7528\u91CF")}:{}}})}});return K({enabled:e.enabled,profiles:n})}function W(e){return[...e].sort((r,n)=>r.maxContextK===null?1:n.maxContextK===null?-1:r.maxContextK===""?1:n.maxContextK===""?-1:Number(r.maxContextK)-Number(n.maxContextK))}function Z(e){return JSON.stringify({enabled:e.enabled,profiles:e.profiles.map(({key:r,...n})=>n)})}function te(e,r,n){let t=V(()=>_(A()),[]),[s,i]=x(t),[o,l]=x(t),[m,f]=x(t.profiles[1].key),[k,g]=x(!1),[ie,M]=x(!0),[ae,de]=x(!1),[O,U]=x(!1),[le,b]=x(null),[ce,F]=x(!1),C=Y(null),v=Z(o)!==Z(s),z=Y(v),h=o.profiles.find(a=>a.key===m)??o.profiles[0],y=V(()=>{try{return{settings:xe(o),issue:null,error:null}}catch(a){return{settings:null,issue:a instanceof P?a.issue:null,error:a instanceof Error?a.message:String(a)}}},[o]);L(()=>{z.current=v},[v]);let I=q((a,c)=>{let p=_(a);i(p),l(p),de(!0),f(p.profiles.find(N=>N.maxContextK===c)?.key??(p.profiles[1]??p.profiles[0]).key)},[]),S=q(async()=>{if(!z.current){M(!0),b(null);try{let a=K(await r.piDesk.invokeGlobal("settings-get",{}));n.aborted||I(a)}catch(a){n.aborted||b(a instanceof Error?a.message:String(a))}finally{n.aborted||M(!1)}}},[I,r,n]);L(()=>{let a=!0;queueMicrotask(()=>{a&&S()});let c=r.connection.subscribe(()=>{r.connection.getSnapshot().status==="ready"&&S()});return()=>{a=!1,c()}},[r,S]),L(()=>(e.setBeforeLeave(()=>!v||new Promise(a=>{C.current?.(!1),C.current=a,F(!0)})),()=>{e.setBeforeLeave(null),C.current?.(!1),C.current=null}),[v,e]);let E=a=>{l(c=>({...c,profiles:c.profiles.map(p=>p.key===h.key?{...p,...a}:p)}))},ue=()=>{if(O||!v)return;if(!y.settings){y.issue?(f(y.issue.profileKey),["maxContextK","checkpointK"].includes(y.issue.field)&&g(!0)):b(y.error);return}U(!0),b(null);let a=JSON.parse(JSON.stringify(y.settings));r.piDesk.invokeGlobal("settings-save",a).then(c=>{n.aborted||(I(K(c),h.maxContextK),r.notify({level:"success",title:"\u8BBE\u7F6E\u5DF2\u4FDD\u5B58"}))}).catch(c=>{if(n.aborted)return;let p=c instanceof Error?c.message:String(c);b(p),r.notify({level:"error",title:"\u8BBE\u7F6E\u4FDD\u5B58\u5931\u8D25",description:p})}).finally(()=>{n.aborted||U(!1)})};return{draft:o,profile:h,issue:y.issue,error:le,loading:ie,loaded:ae,saving:O,dirty:v,advancedOpen:k,leaveOpen:ce,setEnabled(a){l(c=>({...c,enabled:a}))},selectProfile:f,updateProfile:E,updateRule(a,c){E({rules:h.rules.map((p,N)=>N===a?{...p,...c}:p)})},sortProfiles(){l(a=>({...a,profiles:W(a.profiles)}))},addProfile(){let a=A().profiles[1],c=ee({...a,checkpointTokens:void 0,rules:[]});c.maxContextK="",l(p=>({...p,profiles:W([...p.profiles,c])})),f(c.key),g(!0)},deleteProfile(){let a=o.profiles.filter(c=>c.key!==h.key);l({...o,profiles:a}),f(a[0].key)},addRule(){E({rules:[...h.rules,{currentEnabled:!0,currentK:"",projectedEnabled:!0,projectedK:""}]})},removeRule(a){E({rules:h.rules.filter((c,p)=>p!==a)})},setAdvancedOpen:g,cancel(){l(s),b(null)},restoreRecommended(){let a=_(A());l(a),f(a.profiles[1].key),g(!1),b(null)},save:ue,reload(){S()},finishLeave(a){let c=C.current;C.current=null,F(!1),c?.(a)}}}import{Fragment as Ne,jsx as d,jsxs as u}from"react/jsx-runtime";var Ke=`
+.pi-desk-ctx-settings {
+  display: flex;
+  width: 100%;
+  height: 100%;
+  min-height: 0;
+  flex-direction: column;
+}
+.pi-desk-ctx-scroll { min-height: 0; flex: 1; }
+.pi-desk-ctx-viewport { padding: 1.5rem; }
+.pi-desk-ctx-form { display: grid; max-width: 40rem; gap: 1.5rem; }
+.pi-desk-ctx-check { display: flex; min-height: 2rem; align-items: center; gap: .5rem; cursor: pointer; }
+.pi-desk-ctx-models { display: grid; gap: .5rem; }
+.pi-desk-ctx-model-heading { display: flex; align-items: baseline; justify-content: space-between; gap: .5rem; }
+.pi-desk-ctx-model-heading strong { font-weight: 600; }
+.pi-desk-ctx-note { color: var(--muted-foreground); font-size: .75rem; }
+.pi-desk-ctx-tab-error { color: var(--destructive); }
+.pi-desk-ctx-rules { display: grid; gap: .5rem; }
+.pi-desk-ctx-rule {
+  display: grid;
+  min-width: 0;
+  grid-template-columns: minmax(0,1fr) auto minmax(0,1fr) auto;
+  align-items: start;
+  gap: .75rem;
+  margin: 0;
+  border: 0;
+  border-radius: .5rem;
+  padding: .75rem;
+  background: var(--muted);
+}
+.pi-desk-ctx-field { display: grid; min-width: 0; align-content: start; gap: .25rem; }
+.pi-desk-ctx-label { display: flex; min-height: 2rem; align-items: center; font-weight: 500; }
+.pi-desk-ctx-amount { display: grid; min-width: 0; grid-template-columns: 1rem minmax(0,1fr) 1.25rem; align-items: center; gap: .25rem; }
+.pi-desk-ctx-operator { text-align: center; }
+.pi-desk-ctx-unit { color: var(--muted-foreground); font-size: .75rem; }
+.pi-desk-ctx-and { display: grid; height: 2rem; align-items: center; margin-top: 2.25rem; color: var(--muted-foreground); }
+.pi-desk-ctx-remove { margin-top: 2.25rem; }
+.pi-desk-ctx-or { display: flex; align-items: center; gap: .75rem; color: var(--muted-foreground); font-size: .75rem; }
+.pi-desk-ctx-or::before,.pi-desk-ctx-or::after { content: ''; height: 1px; flex: 1; background: var(--border); }
+.pi-desk-ctx-error { color: var(--destructive); font-size: .875rem; }
+.pi-desk-ctx-rule > .pi-desk-ctx-error { grid-column: 1/-1; }
+.pi-desk-ctx-retain { display: grid; grid-template-columns: repeat(2,minmax(0,1fr)); gap: .75rem; }
+.pi-desk-ctx-empty { color: var(--muted-foreground); padding: .75rem 0; }
+.pi-desk-ctx-advanced { border-top: 1px solid var(--border); }
+.pi-desk-ctx-advanced > summary { display: flex; min-height: 2rem; align-items: center; gap: .5rem; border-radius: .375rem; padding: .5rem 0; color: var(--muted-foreground); cursor: pointer; list-style: none; }
+.pi-desk-ctx-advanced > summary::-webkit-details-marker { display: none; }
+.pi-desk-ctx-advanced > summary:hover { color: var(--foreground); }
+.pi-desk-ctx-advanced > summary:focus-visible { outline: 2px solid var(--ring); outline-offset: 2px; }
+.pi-desk-ctx-chevron { width: 1rem; height: 1rem; flex: none; transition: transform 150ms ease-out; }
+.pi-desk-ctx-advanced[open] .pi-desk-ctx-chevron { transform: rotate(90deg); }
+.pi-desk-ctx-advanced-content { display: grid; gap: 1rem; padding-top: .5rem; }
+.pi-desk-ctx-checkpoint { display: grid; max-width: 19rem; gap: .25rem; }
+.pi-desk-ctx-range { display: flex; align-items: start; gap: .75rem; }
+.pi-desk-ctx-range > .pi-desk-ctx-field { flex: 1; max-width: 19rem; }
+.pi-desk-ctx-range-delete { margin-top: 2.25rem; }
+.pi-desk-ctx-footer { flex: none; border-top: 1px solid var(--border); padding: .75rem 1rem; }
+.pi-desk-ctx-footer-end { margin-left: auto; }
+.pi-desk-ctx-unsaved { color: var(--muted-foreground); font-size: .75rem; }
+.pi-desk-ctx-hidden { position: absolute; width: 1px; height: 1px; overflow: hidden; clip-path: inset(50%); white-space: nowrap; }
+@container (max-width:38rem) {
+  .pi-desk-ctx-rule { grid-template-columns: minmax(0,1fr) auto; gap: .25rem .75rem; }
+  .pi-desk-ctx-and { grid-column: 1; height: 1.5rem; margin: 0; justify-content: center; }
+  .pi-desk-ctx-rule > .pi-desk-ctx-field { grid-column: 1; }
+  .pi-desk-ctx-remove { grid-column: 2; grid-row: 1; }
+}
+@container (max-width:32rem) {
+  .pi-desk-ctx-viewport { padding: 1rem; }
+  .pi-desk-ctx-retain { grid-template-columns: minmax(0,1fr); }
+  .pi-desk-ctx-unsaved { display: none; }
+}
+@media (prefers-reduced-motion:reduce) { .pi-desk-ctx-chevron { transition: none; } }
+`;function Ae(e,r){let n=e[r];if(n.maxContextK===null)return"\u5176\u4ED6\u6A21\u578B";if(n.maxContextK==="")return"\u65B0\u8303\u56F4";let t=e[r-1]?.maxContextK;return t?`${t}k\u2013${n.maxContextK}k`:`\u2264 ${n.maxContextK}k`}function w({label:e,value:r,unit:n="k",operator:t="\u2264",enabled:s=!0,disabled:i,error:o,onChange:l,onBlur:m,toggle:f}){let k=re();return u("div",{className:"pi-desk-ctx-field",children:[f?u("label",{className:"pi-desk-ctx-check",children:[d(D,{checked:s,disabled:i,"aria-label":`\u5224\u65AD${e}`,onChange:g=>f(g.target.checked)}),e]}):d("label",{className:"pi-desk-ctx-label",htmlFor:k,children:e}),u("div",{className:"pi-desk-ctx-amount",children:[d("span",{className:"pi-desk-ctx-operator","aria-hidden":"true",children:s?t:""}),d(Te,{id:k,type:s?"number":"text",inputMode:s?n==="\u8F6E"?"numeric":"decimal":void 0,step:n==="\u8F6E"?1:.001,value:s?r:"\u4E0D\u9650",disabled:i||!s,"aria-label":`${e}\uFF08${n}\uFF09`,"aria-invalid":!!o,"aria-describedby":o?`${k}-error`:void 0,onChange:g=>l(g.target.value),onBlur:m}),d("span",{className:"pi-desk-ctx-unit","aria-hidden":"true",children:s?n:""})]}),o?d("span",{className:"pi-desk-ctx-error",id:`${k}-error`,children:o}):null]})}function Ie({settings:e}){let{profile:r,saving:n,issue:t}=e,s=i=>t?.profileKey===r.key&&t.field===i?t.message:void 0;return u(Ne,{children:[d(ne,{title:"\u4F55\u65F6\u5FFD\u7565",action:d(T,{variant:"ghost",disabled:n||r.rules.length>=50,onClick:e.addRule,children:"+ \u6DFB\u52A0\u89C4\u5219"}),children:d("div",{className:"pi-desk-ctx-rules",children:r.rules.length===0?d("div",{className:"pi-desk-ctx-empty",children:"\u5C1A\u672A\u8BBE\u7F6E\u81EA\u52A8\u5FFD\u7565\u6761\u4EF6"}):r.rules.map((i,o)=>u(be,{children:[o>0?d("div",{className:"pi-desk-ctx-or",children:"\u6216"}):null,u("fieldset",{className:"pi-desk-ctx-rule",children:[u("legend",{className:"pi-desk-ctx-hidden",children:["\u5FFD\u7565\u6761\u4EF6 ",o+1]}),d(w,{label:"\u5F53\u524D\u7528\u91CF",operator:"\u2265",value:i.currentK,enabled:i.currentEnabled,disabled:n,error:s(`current-${o}`),onChange:l=>e.updateRule(o,{currentK:l}),toggle:l=>e.updateRule(o,{currentEnabled:l})}),d("span",{className:"pi-desk-ctx-and",children:"\u4E14"}),d(w,{label:"\u5FFD\u7565\u540E\u9884\u8BA1",value:i.projectedK,enabled:i.projectedEnabled,disabled:n,error:s(`projected-${o}`),onChange:l=>e.updateRule(o,{projectedK:l}),toggle:l=>e.updateRule(o,{projectedEnabled:l})}),d(T,{variant:"ghost",className:"pi-desk-ctx-remove","aria-label":`\u79FB\u9664\u89C4\u5219 ${o+1}`,disabled:n,onClick:()=>e.removeRule(o),children:"\u79FB\u9664"}),s(`rule-${o}`)?d("span",{className:"pi-desk-ctx-error",role:"alert",children:s(`rule-${o}`)}):null]})]},o))})}),d(ne,{title:"\u4FDD\u7559\u6700\u8FD1\u7684\u8FC7\u7A0B",description:"\u5BF9\u8BDD\u4E0E\u7ED3\u8BBA\u59CB\u7EC8\u4FDD\u7559",children:u("div",{className:"pi-desk-ctx-retain",children:[d(w,{label:"\u6700\u8FD1\u5BF9\u8BDD\u8F6E\u6570",unit:"\u8F6E",value:r.keepRecentUserTurns,disabled:n,error:s("keepRecentUserTurns"),onChange:i=>e.updateProfile({keepRecentUserTurns:i})}),d(w,{label:"\u8FC7\u7A0B\u7528\u91CF\u4E0A\u9650",value:r.processBudgetK,disabled:n,error:s("processBudgetK"),onChange:i=>e.updateProfile({processBudgetK:i})})]})}),u("details",{className:"pi-desk-ctx-advanced",open:e.advancedOpen,onToggle:i=>e.setAdvancedOpen(i.currentTarget.open),children:[u("summary",{children:[d("svg",{className:"pi-desk-ctx-chevron",viewBox:"0 0 24 24",fill:"none","aria-hidden":"true",children:d("path",{d:"m9 6 6 6-6 6",stroke:"currentColor",strokeWidth:"2"})}),"\u9AD8\u7EA7\u8BBE\u7F6E"]}),u("div",{className:"pi-desk-ctx-advanced-content",children:[u("div",{className:"pi-desk-ctx-checkpoint",children:[u("label",{className:"pi-desk-ctx-check",children:[d(D,{checked:r.checkpointEnabled,disabled:n,onChange:i=>e.updateProfile({checkpointEnabled:i.target.checked})}),"\u4EFB\u52A1\u4E2D\u8BB0\u5F55\u8FDB\u5C55"]}),r.checkpointEnabled?d(w,{label:"\u8FBE\u5230\u7528\u91CF",operator:"\u2265",value:r.checkpointK,disabled:n,error:s("checkpointK"),onChange:i=>e.updateProfile({checkpointK:i})}):null]}),r.maxContextK!==null?u("div",{className:"pi-desk-ctx-range",children:[d(w,{label:"\u6A21\u578B\u5BB9\u91CF\u4E0A\u9650",value:r.maxContextK,disabled:n,error:s("maxContextK"),onChange:i=>e.updateProfile({maxContextK:i}),onBlur:e.sortProfiles}),d(T,{variant:"ghost",className:"pi-desk-ctx-range-delete",disabled:n,onClick:e.deleteProfile,children:"\u5220\u9664\u914D\u7F6E"})]}):null,d(j,{children:d(T,{variant:"ghost",disabled:n||e.draft.profiles.length>=20,onClick:e.addProfile,children:"+ \u6DFB\u52A0\u6A21\u578B\u8303\u56F4"})})]})]})]})}function oe({target:e,host:r,signal:n}){let t=te(e,r,n),s=ve(null),i=re();return u(Se,{className:"pi-desk-ctx-settings","data-pi-desk-ctx-settings":"",children:[d("style",{children:Ke}),d(Pe,{title:"\u4E0A\u4E0B\u6587\u5FFD\u7565",actions:u("label",{className:"pi-desk-ctx-check",children:[d(D,{checked:t.draft.enabled,disabled:t.loading||t.saving,onChange:o=>t.setEnabled(o.target.checked)}),"\u81EA\u52A8\u5FFD\u7565"]})}),d(we,{className:"pi-desk-ctx-scroll",viewportClassName:"pi-desk-ctx-viewport","aria-label":"\u4E0A\u4E0B\u6587\u5FFD\u7565\u8BBE\u7F6E",children:d(Ce,{loading:t.loading,error:t.loaded?null:t.error,onRetry:t.reload,children:u("form",{ref:s,className:"pi-desk-ctx-form",id:`${i}-form`,noValidate:!0,onSubmit:o=>{o.preventDefault(),t.save(),t.issue&&requestAnimationFrame(()=>{s.current?.querySelector('[aria-invalid="true"]')?.focus()})},children:[t.error?d(he,{tone:"error",density:"compact",children:t.error}):null,u("div",{className:"pi-desk-ctx-models",children:[u("div",{className:"pi-desk-ctx-model-heading",children:[d("strong",{children:"\u6A21\u578B\u4E0A\u4E0B\u6587\u5BB9\u91CF"}),d("span",{className:"pi-desk-ctx-note",children:"1k = 1,000 tokens"})]}),d(Re,{label:"\u6A21\u578B\u4E0A\u4E0B\u6587\u5BB9\u91CF",children:t.draft.profiles.map((o,l)=>u(Ee,{id:`${i}-${o.key}`,active:t.profile.key===o.key,"aria-controls":`${i}-fields`,disabled:t.saving,tabIndex:t.profile.key===o.key?0:-1,onKeyDown:m=>{let f=t.draft.profiles.length-1,k=m.key==="ArrowRight"?(l+1)%(f+1):m.key==="ArrowLeft"?(l+f)%(f+1):m.key==="Home"?0:m.key==="End"?f:null;if(k===null)return;m.preventDefault();let g=t.draft.profiles[k];t.selectProfile(g.key),document.getElementById(`${i}-${g.key}`)?.focus()},onClick:()=>t.selectProfile(o.key),children:[Ae(t.draft.profiles,l),t.issue?.profileKey===o.key?u("span",{className:"pi-desk-ctx-tab-error","aria-label":"\u914D\u7F6E\u5F85\u5B8C\u5584",children:[" ","\xB7 !"]}):null]},o.key))})]}),d("div",{role:"tabpanel",id:`${i}-fields`,"aria-labelledby":`${i}-${t.profile.key}`,className:"pi-desk-ctx-form",children:d(Ie,{settings:t})})]})})}),!t.loading&&t.loaded?u(j,{align:"between",className:"pi-desk-ctx-footer",children:[d(T,{variant:"ghost",disabled:t.saving,onClick:t.restoreRecommended,children:"\u6062\u590D\u63A8\u8350"}),u(j,{className:"pi-desk-ctx-footer-end",children:[t.dirty?d("span",{className:"pi-desk-ctx-unsaved",children:"\u672A\u4FDD\u5B58"}):null,t.dirty?d(T,{disabled:t.saving,onClick:t.cancel,children:"\u53D6\u6D88\u4FEE\u6539"}):null,d(T,{variant:"primary",type:"submit",form:`${i}-form`,disabled:!t.dirty||t.saving,children:t.saving?"\u4FDD\u5B58\u4E2D\u2026":"\u4FDD\u5B58"})]})]}):null,d(ye,{open:t.leaveOpen,title:"\u653E\u5F03\u672A\u4FDD\u5B58\u7684\u66F4\u6539\uFF1F",confirmLabel:"\u653E\u5F03\u66F4\u6539",tone:"danger",onConfirm:()=>t.finishLeave(!0),onOpenChange:o=>{o||t.finishLeave(!1)}})]})}import{jsx as se}from"react/jsx-runtime";var Ge={mount({container:e,target:r,host:n,signal:t}){let s=$e(e);return s.render(se(Be,{onError:i=>n.notify({level:"error",title:"\u4E0A\u4E0B\u6587\u5FFD\u7565\u8BBE\u7F6E\u6E32\u67D3\u5931\u8D25",description:i.message}),children:se(oe,{target:r,host:n,signal:t})})),()=>s.unmount()}};export{Ge as contextIgnoreSettingsPage};

package/dist/browser/entry.js

@@ -0,0 +1 @@
+function t(e){if(typeof e!="function")throw new Error("Browser Entry factory must be a function");return e}var o=()=>import("./chunks/browser-DJVEFCDQ.js"),a=t(e=>{e.registerContribution("settings-page","context-ignore",{label:"\u4E0A\u4E0B\u6587\u5FFD\u7565",icon:{type:"builtin",name:"bot"},load:()=>o().then(n=>n.contextIgnoreSettingsPage)})});export{a as default};

package/dist/context-analysis.d.ts

@@ -0,0 +1,21 @@
+import type { AgentMessage } from '@earendil-works/pi-agent-core';
+import { type ContextIgnoreTransformOptions } from './context-skill-path.js';
+import type { ContextIgnoreAnalysis, ContextIgnorePotential, ContextIgnoreState } from './types.js';
+/**
+ * 用当前请求的真实 Provider 上下文校正本地字符估算。
+ * signature 是不透明的编码内容，不能假定固定的字符/token 比例。
+ */
+export declare function calibrateProviderTokens(estimatedTokens: number, estimatedContextTokens: number, actualContextTokens: number | null | undefined): number;
+export declare function analyzeContext(messages: AgentMessage[], state: ContextIgnoreState, options?: ContextIgnoreTransformOptions): ContextIgnoreAnalysis;
+export declare function findCutoffTimestamp(messages: AgentMessage[], keepTurns: number): number | undefined;
+export interface RecentProcessCandidate {
+    cutoffTimestamp: number;
+    nextState: ContextIgnoreState;
+    potential: ContextIgnorePotential;
+}
+/**
+ * Keeps compressible process details from at most the latest user turns within one shared budget.
+ * User messages, assistant text, and protected Skill reads are retained regardless of this boundary.
+ */
+export declare function selectRecentProcessCandidate(messages: AgentMessage[], currentState: ContextIgnoreState, keepTurns: number, processTokenBudget: number, options?: ContextIgnoreTransformOptions): RecentProcessCandidate | undefined;
+export declare function analyzeIgnorePotential(messages: AgentMessage[], currentState: ContextIgnoreState, keepTurns: number, processTokenBudget: number, options?: ContextIgnoreTransformOptions): ContextIgnorePotential;

package/dist/context-analysis.js

@@ -0,0 +1,194 @@
+import { emptyContextIgnorePotential } from './auto-ignore.js';
+import { estimateTokens } from '@earendil-works/pi-coding-agent';
+import { estimateReasoningReplayTokens, estimateThinkingBlockTokens, estimateToolCallTokens } from './context-token-estimate.js';
+import { getIgnoredMessageIndexes, transformContextMessages } from './context-transform.js';
+import { getSkillBaseDirs, isSkillContentRead } from './context-skill-path.js';
+function sumReasoningReplayTokens(messages) {
+    let tokens = 0;
+    for (const message of messages) {
+        if (message.role !== 'assistant')
+            continue;
+        for (const block of message.content) {
+            if (block.type === 'thinking')
+                tokens += estimateReasoningReplayTokens(block);
+        }
+    }
+    return tokens;
+}
+/**
+ * 用当前请求的真实 Provider 上下文校正本地字符估算。
+ * signature 是不透明的编码内容，不能假定固定的字符/token 比例。
+ */
+export function calibrateProviderTokens(estimatedTokens, estimatedContextTokens, actualContextTokens) {
+    if (actualContextTokens === null ||
+        actualContextTokens === undefined ||
+        estimatedTokens <= 0 ||
+        estimatedContextTokens <= 0) {
+        return Math.max(0, estimatedTokens);
+    }
+    return Math.max(0, Math.round((estimatedTokens * actualContextTokens) / estimatedContextTokens));
+}
+export function analyzeContext(messages, state, options = {}) {
+    const transformed = transformContextMessages(messages, state, options);
+    const ignoredMessageIndexes = getIgnoredMessageIndexes(messages, state);
+    let completeTurns = 0;
+    for (const [index, message] of messages.entries()) {
+        if (message.role === 'user' && !ignoredMessageIndexes.has(index))
+            completeTurns += 1;
+    }
+    const rawTokens = messages.reduce((total, message) => total + estimateTokens(message), 0);
+    const effectiveTokens = transformed.messages.reduce((total, message) => total + estimateTokens(message), 0);
+    const ignoredTokens = Math.max(0, rawTokens - effectiveTokens);
+    const effectiveReasoningReplayTokens = sumReasoningReplayTokens(transformed.messages);
+    const reasoningReplayTokens = Math.max(0, sumReasoningReplayTokens(messages) - effectiveReasoningReplayTokens);
+    return {
+        rawTokens,
+        effectiveTokens,
+        providerEffectiveTokens: effectiveTokens + effectiveReasoningReplayTokens,
+        ignoredTokens,
+        providerIgnoredTokens: ignoredTokens + reasoningReplayTokens,
+        reasoningReplayTokens,
+        completeTurns
+    };
+}
+export function findCutoffTimestamp(messages, keepTurns) {
+    const userMessages = messages.filter((message) => message.role === 'user');
+    if (userMessages.length === 0) {
+        // 压缩可能将用户消息收进摘要，只保留当前轮的助手过程，仍需按过程预算处理。
+        return messages.find((message) => message.role === 'assistant')?.timestamp;
+    }
+    const index = Math.max(0, userMessages.length - keepTurns);
+    return userMessages[index]?.timestamp;
+}
+function createUserTurnCandidateState(currentState, cutoffTimestamp, keepTurns) {
+    return {
+        ...currentState,
+        enabled: true,
+        mode: currentState.internalTurnCutoffs === undefined ? 'user-turns' : 'combined',
+        cutoffTimestamp: Math.max(currentState.cutoffTimestamp ?? 0, cutoffTimestamp),
+        keepTurns,
+        updatedAt: Date.now()
+    };
+}
+function createPotential(current, candidate) {
+    const reasoningReplayTokens = Math.max(0, candidate.reasoningReplayTokens - current.reasoningReplayTokens);
+    const netTokens = Math.max(0, current.effectiveTokens - candidate.effectiveTokens);
+    return {
+        reasoningReplayTokens,
+        netTokens,
+        providerNetTokens: netTokens + reasoningReplayTokens
+    };
+}
+function afterTimestamp(timestamp) {
+    return timestamp < Number.MAX_SAFE_INTEGER ? timestamp + 1 : timestamp;
+}
+function createRetainedProcessBudgetIndex(messages, state, options) {
+    const internalIgnoredIndexes = getIgnoredMessageIndexes(messages, {
+        ...state,
+        enabled: true,
+        cutoffTimestamp: undefined
+    });
+    const skillBaseDirs = getSkillBaseDirs(messages, options);
+    const assistantTokens = [];
+    const nonSkillToolCalls = [];
+    const toolResults = [];
+    const skillToolCallIds = new Set();
+    for (const message of messages) {
+        if (message.role !== 'assistant')
+            continue;
+        for (const block of message.content) {
+            if (block.type === 'toolCall' && isSkillContentRead(block, skillBaseDirs, options)) {
+                skillToolCallIds.add(block.id);
+            }
+        }
+    }
+    for (const [messageIndex, message] of messages.entries()) {
+        if (message.role === 'toolResult') {
+            if (!skillToolCallIds.has(message.toolCallId)) {
+                toolResults.push({
+                    messageIndex,
+                    toolCallId: message.toolCallId,
+                    tokens: estimateTokens(message)
+                });
+            }
+            continue;
+        }
+        if (message.role !== 'assistant')
+            continue;
+        let tokens = 0;
+        for (const block of message.content) {
+            if (block.type === 'thinking') {
+                tokens += estimateThinkingBlockTokens(block);
+                tokens += estimateReasoningReplayTokens(block);
+            }
+            else if (block.type === 'toolCall' && !skillToolCallIds.has(block.id)) {
+                tokens += estimateToolCallTokens(block);
+                nonSkillToolCalls.push({ messageIndex, toolCallId: block.id });
+            }
+        }
+        if (tokens > 0)
+            assistantTokens.push({ messageIndex, tokens });
+    }
+    return {
+        internalIgnoredIndexes,
+        assistantTokens,
+        nonSkillToolCalls,
+        toolResults
+    };
+}
+function estimateRetainedCompressibleProcessTokens(messages, state, index) {
+    const cutoffTimestamp = state.cutoffTimestamp;
+    const isIgnored = (messageIndex) => index.internalIgnoredIndexes.has(messageIndex) ||
+        (cutoffTimestamp !== undefined && messages[messageIndex].timestamp < cutoffTimestamp);
+    const ignoredToolCallIds = new Set();
+    for (const toolCall of index.nonSkillToolCalls) {
+        if (isIgnored(toolCall.messageIndex))
+            ignoredToolCallIds.add(toolCall.toolCallId);
+    }
+    let tokens = 0;
+    for (const assistant of index.assistantTokens) {
+        if (!isIgnored(assistant.messageIndex))
+            tokens += assistant.tokens;
+    }
+    for (const result of index.toolResults) {
+        if (!isIgnored(result.messageIndex) && !ignoredToolCallIds.has(result.toolCallId)) {
+            tokens += result.tokens;
+        }
+    }
+    return tokens;
+}
+/**
+ * Keeps compressible process details from at most the latest user turns within one shared budget.
+ * User messages, assistant text, and protected Skill reads are retained regardless of this boundary.
+ */
+export function selectRecentProcessCandidate(messages, currentState, keepTurns, processTokenBudget, options = {}) {
+    const userCutoffTimestamp = findCutoffTimestamp(messages, keepTurns);
+    if (userCutoffTimestamp === undefined)
+        return undefined;
+    const current = analyzeContext(messages, currentState, options);
+    const assistants = messages.filter((message) => message.role === 'assistant' && message.timestamp >= userCutoffTimestamp);
+    const latestMessageTimestamp = messages.reduce((latest, message) => Math.max(latest, message.timestamp), userCutoffTimestamp);
+    const candidateCutoffs = [
+        userCutoffTimestamp,
+        ...assistants.map((message) => message.timestamp),
+        afterTimestamp(latestMessageTimestamp)
+    ];
+    const budgetIndex = createRetainedProcessBudgetIndex(messages, currentState, options);
+    for (const cutoffTimestamp of [...new Set(candidateCutoffs)]) {
+        const nextState = createUserTurnCandidateState(currentState, cutoffTimestamp, keepTurns);
+        const retainedProcessTokens = estimateRetainedCompressibleProcessTokens(messages, nextState, budgetIndex);
+        if (retainedProcessTokens > processTokenBudget)
+            continue;
+        const candidate = analyzeContext(messages, nextState, options);
+        return {
+            cutoffTimestamp: nextState.cutoffTimestamp,
+            nextState,
+            potential: createPotential(current, candidate)
+        };
+    }
+    return undefined;
+}
+export function analyzeIgnorePotential(messages, currentState, keepTurns, processTokenBudget, options = {}) {
+    return (selectRecentProcessCandidate(messages, currentState, keepTurns, processTokenBudget, options)
+        ?.potential ?? emptyContextIgnorePotential());
+}

package/dist/context-compaction.d.ts

@@ -0,0 +1,5 @@
+import type { AgentMessage } from '@earendil-works/pi-agent-core';
+import type { SessionBeforeCompactEvent } from '@earendil-works/pi-coding-agent';
+import type { ContextIgnoreTransformOptions } from './context-skill-path.js';
+import type { ContextIgnoreState } from './types.js';
+export declare function transformCompactionPreparation(preparation: SessionBeforeCompactEvent['preparation'], sessionMessages: AgentMessage[], state: ContextIgnoreState, ignoredTokens: number, options?: ContextIgnoreTransformOptions): void;

package/dist/context-compaction.js

@@ -0,0 +1,14 @@
+import { getIgnoredMessageReferences, transformContextMessages } from './context-transform.js';
+export function transformCompactionPreparation(preparation, sessionMessages, state, ignoredTokens, options = {}) {
+    if (!state.enabled ||
+        (state.cutoffTimestamp === undefined && state.internalTurnCutoffs === undefined)) {
+        return;
+    }
+    const transformOptions = {
+        ...options,
+        ignoredMessages: getIgnoredMessageReferences(sessionMessages, state)
+    };
+    preparation.messagesToSummarize = transformContextMessages(preparation.messagesToSummarize, state, transformOptions).messages;
+    preparation.turnPrefixMessages = transformContextMessages(preparation.turnPrefixMessages, state, transformOptions).messages;
+    preparation.tokensBefore = Math.max(0, preparation.tokensBefore - ignoredTokens);
+}

package/dist/context-history-tool.d.ts

@@ -0,0 +1,12 @@
+import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
+export declare const HISTORY_TOOL_RESULT_NAME = "history_tool_result";
+type HistoricalToolStatus = 'ok' | 'error' | 'missing';
+export type HistoricalToolResultDetails = {
+    ref: number;
+    toolCallId: string;
+    toolName: string;
+    historicalStatus: HistoricalToolStatus;
+    timestamp?: number;
+};
+export declare function registerHistoryToolResult(pi: ExtensionAPI, getToolReferences: () => ReadonlyMap<number, string>): void;
+export {};