@infituit/opencode-acp 0.0.0-stage → 2.0.0-alpha.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (192) hide show
  1. package/LICENSE +622 -0
  2. package/NOTICE +29 -0
  3. package/README.md +203 -2
  4. package/dist/auth.d.ts +4 -0
  5. package/dist/auth.d.ts.map +1 -0
  6. package/dist/commands/compression-targets.d.ts +13 -0
  7. package/dist/commands/compression-targets.d.ts.map +1 -0
  8. package/dist/commands/context.d.ts +52 -0
  9. package/dist/commands/context.d.ts.map +1 -0
  10. package/dist/commands/export.d.ts +56 -0
  11. package/dist/commands/export.d.ts.map +1 -0
  12. package/dist/commands/index.d.ts +4 -0
  13. package/dist/commands/index.d.ts.map +1 -0
  14. package/dist/commands/stats.d.ts +19 -0
  15. package/dist/commands/stats.d.ts.map +1 -0
  16. package/dist/compress/decompress-logic.d.ts +62 -0
  17. package/dist/compress/decompress-logic.d.ts.map +1 -0
  18. package/dist/compress/decompress.d.ts +4 -0
  19. package/dist/compress/decompress.d.ts.map +1 -0
  20. package/dist/compress/hide-consumed.d.ts +15 -0
  21. package/dist/compress/hide-consumed.d.ts.map +1 -0
  22. package/dist/compress/hide-failed.d.ts +3 -0
  23. package/dist/compress/hide-failed.d.ts.map +1 -0
  24. package/dist/compress/image-archive.d.ts +43 -0
  25. package/dist/compress/image-archive.d.ts.map +1 -0
  26. package/dist/compress/index.d.ts +9 -0
  27. package/dist/compress/index.d.ts.map +1 -0
  28. package/dist/compress/keep-markers.d.ts +11 -0
  29. package/dist/compress/keep-markers.d.ts.map +1 -0
  30. package/dist/compress/parts.d.ts +4 -0
  31. package/dist/compress/parts.d.ts.map +1 -0
  32. package/dist/compress/pipeline.d.ts +141 -0
  33. package/dist/compress/pipeline.d.ts.map +1 -0
  34. package/dist/compress/protected-content.d.ts +12 -0
  35. package/dist/compress/protected-content.d.ts.map +1 -0
  36. package/dist/compress/quality-gate/algorithms/index.d.ts +3 -0
  37. package/dist/compress/quality-gate/algorithms/index.d.ts.map +1 -0
  38. package/dist/compress/quality-gate/evaluate.d.ts +21 -0
  39. package/dist/compress/quality-gate/evaluate.d.ts.map +1 -0
  40. package/dist/compress/quality-gate/index.d.ts +7 -0
  41. package/dist/compress/quality-gate/index.d.ts.map +1 -0
  42. package/dist/compress/quality-gate/registry.d.ts +6 -0
  43. package/dist/compress/quality-gate/registry.d.ts.map +1 -0
  44. package/dist/compress/quality-gate/rejection.d.ts +18 -0
  45. package/dist/compress/quality-gate/rejection.d.ts.map +1 -0
  46. package/dist/compress/quality-gate/types.d.ts +51 -0
  47. package/dist/compress/quality-gate/types.d.ts.map +1 -0
  48. package/dist/compress/range-utils.d.ts +28 -0
  49. package/dist/compress/range-utils.d.ts.map +1 -0
  50. package/dist/compress/range.d.ts +8 -0
  51. package/dist/compress/range.d.ts.map +1 -0
  52. package/dist/compress/recap.d.ts +4 -0
  53. package/dist/compress/recap.d.ts.map +1 -0
  54. package/dist/compress/search.d.ts +17 -0
  55. package/dist/compress/search.d.ts.map +1 -0
  56. package/dist/compress/smart-plan.d.ts +28 -0
  57. package/dist/compress/smart-plan.d.ts.map +1 -0
  58. package/dist/compress/state.d.ts +10 -0
  59. package/dist/compress/state.d.ts.map +1 -0
  60. package/dist/compress/status.d.ts +19 -0
  61. package/dist/compress/status.d.ts.map +1 -0
  62. package/dist/compress/timing.d.ts +17 -0
  63. package/dist/compress/timing.d.ts.map +1 -0
  64. package/dist/compress/types.d.ts +120 -0
  65. package/dist/compress/types.d.ts.map +1 -0
  66. package/dist/compress-permission.d.ts +6 -0
  67. package/dist/compress-permission.d.ts.map +1 -0
  68. package/dist/config-validation.d.ts +13 -0
  69. package/dist/config-validation.d.ts.map +1 -0
  70. package/dist/config.d.ts +248 -0
  71. package/dist/config.d.ts.map +1 -0
  72. package/dist/gc/merge.d.ts +17 -0
  73. package/dist/gc/merge.d.ts.map +1 -0
  74. package/dist/hooks.d.ts +41 -0
  75. package/dist/hooks.d.ts.map +1 -0
  76. package/dist/host-permissions.d.ts +31 -0
  77. package/dist/host-permissions.d.ts.map +1 -0
  78. package/dist/index.d.ts +3 -0
  79. package/dist/index.d.ts.map +1 -0
  80. package/dist/index.js +14411 -0
  81. package/dist/index.js.map +1 -0
  82. package/dist/logger.d.ts +48 -0
  83. package/dist/logger.d.ts.map +1 -0
  84. package/dist/message-ids.d.ts +27 -0
  85. package/dist/message-ids.d.ts.map +1 -0
  86. package/dist/messages/enforce-budget.d.ts +65 -0
  87. package/dist/messages/enforce-budget.d.ts.map +1 -0
  88. package/dist/messages/filter/apply.d.ts +14 -0
  89. package/dist/messages/filter/apply.d.ts.map +1 -0
  90. package/dist/messages/filter/builtin/index.d.ts +2 -0
  91. package/dist/messages/filter/builtin/index.d.ts.map +1 -0
  92. package/dist/messages/filter/builtin/omo-context.d.ts +4 -0
  93. package/dist/messages/filter/builtin/omo-context.d.ts.map +1 -0
  94. package/dist/messages/filter/builtin/omo-mode-injection.d.ts +4 -0
  95. package/dist/messages/filter/builtin/omo-mode-injection.d.ts.map +1 -0
  96. package/dist/messages/filter/builtin/omo-system-reminder.d.ts +4 -0
  97. package/dist/messages/filter/builtin/omo-system-reminder.d.ts.map +1 -0
  98. package/dist/messages/filter/builtin/omo-task-directive.d.ts +4 -0
  99. package/dist/messages/filter/builtin/omo-task-directive.d.ts.map +1 -0
  100. package/dist/messages/filter/builtin/omo-todo-continuation.d.ts +4 -0
  101. package/dist/messages/filter/builtin/omo-todo-continuation.d.ts.map +1 -0
  102. package/dist/messages/filter/index.d.ts +6 -0
  103. package/dist/messages/filter/index.d.ts.map +1 -0
  104. package/dist/messages/filter/registry.d.ts +6 -0
  105. package/dist/messages/filter/registry.d.ts.map +1 -0
  106. package/dist/messages/filter/types.d.ts +95 -0
  107. package/dist/messages/filter/types.d.ts.map +1 -0
  108. package/dist/messages/index.d.ts +9 -0
  109. package/dist/messages/index.d.ts.map +1 -0
  110. package/dist/messages/inject/candidates.d.ts +30 -0
  111. package/dist/messages/inject/candidates.d.ts.map +1 -0
  112. package/dist/messages/inject/inject.d.ts +26 -0
  113. package/dist/messages/inject/inject.d.ts.map +1 -0
  114. package/dist/messages/inject/policy/index.d.ts +5 -0
  115. package/dist/messages/inject/policy/index.d.ts.map +1 -0
  116. package/dist/messages/inject/policy/registry.d.ts +8 -0
  117. package/dist/messages/inject/policy/registry.d.ts.map +1 -0
  118. package/dist/messages/inject/policy/types.d.ts +2 -0
  119. package/dist/messages/inject/policy/types.d.ts.map +1 -0
  120. package/dist/messages/inject/utils.d.ts +235 -0
  121. package/dist/messages/inject/utils.d.ts.map +1 -0
  122. package/dist/messages/priority.d.ts +13 -0
  123. package/dist/messages/priority.d.ts.map +1 -0
  124. package/dist/messages/prune.d.ts +5 -0
  125. package/dist/messages/prune.d.ts.map +1 -0
  126. package/dist/messages/query.d.ts +36 -0
  127. package/dist/messages/query.d.ts.map +1 -0
  128. package/dist/messages/reasoning-strip.d.ts +32 -0
  129. package/dist/messages/reasoning-strip.d.ts.map +1 -0
  130. package/dist/messages/shape.d.ts +5 -0
  131. package/dist/messages/shape.d.ts.map +1 -0
  132. package/dist/messages/sticky-truncation.d.ts +55 -0
  133. package/dist/messages/sticky-truncation.d.ts.map +1 -0
  134. package/dist/messages/sync.d.ts +4 -0
  135. package/dist/messages/sync.d.ts.map +1 -0
  136. package/dist/messages/truncate-tools.d.ts +12 -0
  137. package/dist/messages/truncate-tools.d.ts.map +1 -0
  138. package/dist/messages/utils.d.ts +30 -0
  139. package/dist/messages/utils.d.ts.map +1 -0
  140. package/dist/prompts/compress-range.d.ts +10 -0
  141. package/dist/prompts/compress-range.d.ts.map +1 -0
  142. package/dist/prompts/context-limit-nudge.d.ts +8 -0
  143. package/dist/prompts/context-limit-nudge.d.ts.map +1 -0
  144. package/dist/prompts/extensions/nudge.d.ts +16 -0
  145. package/dist/prompts/extensions/nudge.d.ts.map +1 -0
  146. package/dist/prompts/extensions/system.d.ts +4 -0
  147. package/dist/prompts/extensions/system.d.ts.map +1 -0
  148. package/dist/prompts/extensions/tool.d.ts +3 -0
  149. package/dist/prompts/extensions/tool.d.ts.map +1 -0
  150. package/dist/prompts/index.d.ts +4 -0
  151. package/dist/prompts/index.d.ts.map +1 -0
  152. package/dist/prompts/iteration-nudge.d.ts +7 -0
  153. package/dist/prompts/iteration-nudge.d.ts.map +1 -0
  154. package/dist/prompts/store.d.ts +25 -0
  155. package/dist/prompts/store.d.ts.map +1 -0
  156. package/dist/prompts/system.d.ts +11 -0
  157. package/dist/prompts/system.d.ts.map +1 -0
  158. package/dist/prompts/turn-nudge.d.ts +7 -0
  159. package/dist/prompts/turn-nudge.d.ts.map +1 -0
  160. package/dist/protected-patterns.d.ts +5 -0
  161. package/dist/protected-patterns.d.ts.map +1 -0
  162. package/dist/state/index.d.ts +6 -0
  163. package/dist/state/index.d.ts.map +1 -0
  164. package/dist/state/message-types.d.ts +90 -0
  165. package/dist/state/message-types.d.ts.map +1 -0
  166. package/dist/state/model-limits.d.ts +27 -0
  167. package/dist/state/model-limits.d.ts.map +1 -0
  168. package/dist/state/persistence.d.ts +93 -0
  169. package/dist/state/persistence.d.ts.map +1 -0
  170. package/dist/state/rebuild.d.ts +40 -0
  171. package/dist/state/rebuild.d.ts.map +1 -0
  172. package/dist/state/state.d.ts +36 -0
  173. package/dist/state/state.d.ts.map +1 -0
  174. package/dist/state/tool-cache.d.ts +13 -0
  175. package/dist/state/tool-cache.d.ts.map +1 -0
  176. package/dist/state/types.d.ts +221 -0
  177. package/dist/state/types.d.ts.map +1 -0
  178. package/dist/state/utils.d.ts +57 -0
  179. package/dist/state/utils.d.ts.map +1 -0
  180. package/dist/token-utils.d.ts +42 -0
  181. package/dist/token-utils.d.ts.map +1 -0
  182. package/dist/ui/notification.d.ts +13 -0
  183. package/dist/ui/notification.d.ts.map +1 -0
  184. package/dist/ui/utils.d.ts +6 -0
  185. package/dist/ui/utils.d.ts.map +1 -0
  186. package/dist/update.d.ts +24 -0
  187. package/dist/update.d.ts.map +1 -0
  188. package/dist/v2/messages.d.ts +7 -0
  189. package/dist/v2/messages.d.ts.map +1 -0
  190. package/dist/v2/plugin.d.ts +3 -0
  191. package/dist/v2/plugin.d.ts.map +1 -0
  192. package/package.json +76 -5
@@ -0,0 +1,11 @@
1
+ /**
2
+ * Build the bundled ACP system prompt.
3
+ *
4
+ * candidatesEnabled mirrors `compress.candidates`: false renders the legacy
5
+ * range-based guidance (behavior identical to pre-candidate master), true
6
+ * renders MICRO/EPISODE candidate guidance. All other wording is shared.
7
+ */
8
+ export declare function buildSystemPrompt(candidatesEnabled: boolean): string;
9
+ /** Bundled system prompt with candidate guidance enabled (`compress.candidates: true`). */
10
+ export declare const SYSTEM: string;
11
+ //# sourceMappingURL=system.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/prompts/system.ts"],"names":[],"mappings":"AA4BA;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,iBAAiB,EAAE,OAAO,GAAG,MAAM,CA8FpE;AAED,2FAA2F;AAC3F,eAAO,MAAM,MAAM,QAA0B,CAAA"}
@@ -0,0 +1,7 @@
1
+ export declare const TURN_NUDGE = "\n<system-reminder>\nContext is getting full. If you've finished reading tool outputs or exploration results, compress them \u2014 you can decompress later if needed. This keeps your focus on the current task and improves accuracy.\n\n{\n \"topic\": \"Short Label\",\n \"content\": [{ \"startId\": \"<visible message ID>\", \"endId\": \"<visible message ID>\", \"summary\": \"...\" }]\n}\n\n\u26A0\uFE0F ONLY use IDs from tags visible above. Do NOT invent or copy example IDs.\n</system-reminder>\n";
2
+ /**
3
+ * Candidate-mode guidance appended to the turn nudge when
4
+ * `compress.candidates` is enabled.
5
+ */
6
+ export declare const TURN_CANDIDATE_GUIDANCE = "\nMICRO candidates are complete large messages or tool transactions. EPISODE candidates are contiguous historical segments. They are independent suggestions and may be batched, but compress only content no longer needed for the current task. Do not compress active work or every candidate.\n";
7
+ //# sourceMappingURL=turn-nudge.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"turn-nudge.d.ts","sourceRoot":"","sources":["../../src/prompts/turn-nudge.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,0fAWtB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB,wSAEnC,CAAA"}
@@ -0,0 +1,5 @@
1
+ export declare function matchesGlob(inputPath: string, pattern: string): boolean;
2
+ export declare function getFilePathsFromParameters(tool: string, parameters: unknown): string[];
3
+ export declare function isFilePathProtected(filePaths: string[], patterns: string[]): boolean;
4
+ export declare function isToolNameProtected(toolName: string, patterns: string[]): boolean;
5
+ //# sourceMappingURL=protected-patterns.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"protected-patterns.d.ts","sourceRoot":"","sources":["../src/protected-patterns.ts"],"names":[],"mappings":"AAYA,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAiDvE;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,EAAE,CAsCtF;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAKpF;AAID,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAmBjF"}
@@ -0,0 +1,6 @@
1
+ export * from "./persistence";
2
+ export * from "./types";
3
+ export * from "./state";
4
+ export * from "./model-limits";
5
+ export * from "./tool-cache";
6
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA;AACvB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA"}
@@ -0,0 +1,90 @@
1
+ export interface MessageTime {
2
+ created: number;
3
+ completed?: number;
4
+ }
5
+ export interface UserMessage {
6
+ id: string;
7
+ sessionID: string;
8
+ role: "user";
9
+ time: MessageTime;
10
+ agent: string;
11
+ model: {
12
+ providerID: string;
13
+ modelID: string;
14
+ variant?: string;
15
+ };
16
+ [key: string]: unknown;
17
+ }
18
+ export interface AssistantMessage {
19
+ id: string;
20
+ sessionID: string;
21
+ role: "assistant";
22
+ time: MessageTime;
23
+ parentID: string;
24
+ modelID: string;
25
+ providerID: string;
26
+ mode: string;
27
+ agent: string;
28
+ path: {
29
+ cwd: string;
30
+ root: string;
31
+ };
32
+ cost: number;
33
+ tokens: {
34
+ input: number;
35
+ output: number;
36
+ reasoning: number;
37
+ cache: {
38
+ read: number;
39
+ write: number;
40
+ };
41
+ };
42
+ summary?: boolean;
43
+ [key: string]: unknown;
44
+ }
45
+ export type Message = UserMessage | AssistantMessage;
46
+ export interface TextPart {
47
+ type: "text";
48
+ text: string;
49
+ id?: string;
50
+ sessionID?: string;
51
+ messageID?: string;
52
+ synthetic?: boolean;
53
+ [key: string]: unknown;
54
+ }
55
+ export interface ReasoningPart {
56
+ type: "reasoning";
57
+ text: string;
58
+ [key: string]: unknown;
59
+ }
60
+ export interface ToolPart {
61
+ type: "tool";
62
+ callID: string;
63
+ tool: string;
64
+ messageID?: string;
65
+ state?: {
66
+ status: string;
67
+ input?: unknown;
68
+ output?: string;
69
+ time?: {
70
+ start?: number;
71
+ end?: number;
72
+ completed?: number;
73
+ };
74
+ [key: string]: unknown;
75
+ };
76
+ [key: string]: unknown;
77
+ }
78
+ export interface FilePart {
79
+ type: "file";
80
+ url?: string;
81
+ mime?: string;
82
+ filename?: string;
83
+ [key: string]: unknown;
84
+ }
85
+ export interface GenericPart {
86
+ type: string;
87
+ [key: string]: unknown;
88
+ }
89
+ export type Part = any;
90
+ //# sourceMappingURL=message-types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"message-types.d.ts","sourceRoot":"","sources":["../../src/state/message-types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,27 @@
1
+ /**
2
+ * [FIX #312] Catalog of per-model context limits, keyed `${providerID}/${modelID}`.
3
+ *
4
+ * Within one LLM request the host fires experimental.chat.messages.transform
5
+ * BEFORE experimental.chat.system.transform (sst/opencode: session/prompt.ts
6
+ * triggers messages.transform, then llm/request.ts triggers system.transform
7
+ * during handle.process). state.modelContextLimit is written only by the
8
+ * system hook, so on the first request after a model switch every percentage
9
+ * threshold (emergencyThresholdPercent, min/maxContextLimit "%", GC tiers) is
10
+ * still computed against the PREVIOUS model's
11
+ * limit. This catalog lets the messages hook reconcile against the model
12
+ * named on the request's user message instead of waiting one turn.
13
+ *
14
+ * Entries are recorded live by the system hook every request and seeded once
15
+ * at plugin init from the host's /config/providers catalog.
16
+ *
17
+ * Standalone factory (not embedded in SessionStateRegistry) so the test
18
+ * registry stub can compose the SAME implementation instead of hand-rolling
19
+ * a drift-prone copy.
20
+ */
21
+ export interface ModelLimitCatalog {
22
+ record(providerId: string | undefined, modelId: string | undefined, limit: number | undefined): void;
23
+ resolve(providerId: string | undefined, modelId: string | undefined): number | undefined;
24
+ hydrateFromClient(client: unknown): Promise<number>;
25
+ }
26
+ export declare function createModelLimitCatalog(): ModelLimitCatalog;
27
+ //# sourceMappingURL=model-limits.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"model-limits.d.ts","sourceRoot":"","sources":["../../src/state/model-limits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,iBAAiB;IAC9B,MAAM,CACF,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,KAAK,EAAE,MAAM,GAAG,SAAS,GAC1B,IAAI,CAAA;IACP,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAA;IACxF,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACtD;AAED,wBAAgB,uBAAuB,IAAI,iBAAiB,CA6C3D"}
@@ -0,0 +1,93 @@
1
+ /**
2
+ * State persistence module for ACP plugin.
3
+ * Persists pruned tool IDs across sessions so they survive OpenCode restarts.
4
+ * Storage location: $XDG_DATA_HOME/opencode/storage/plugin/acp/{sessionId}.json
5
+ * by default, or the directory configured via `storagePath` (see resolveStorageDir).
6
+ */
7
+ import type { ArchivedImageEntry, CompressionBlock, PrunedMessageEntry, SessionState, SessionStats } from "./types";
8
+ import type { Logger } from "../logger";
9
+ export interface NativeStateStorage {
10
+ get(key: string): Promise<unknown>;
11
+ set(key: string, value: unknown): Promise<void>;
12
+ scan?(options: {
13
+ prefix: string;
14
+ after?: string;
15
+ limit?: number;
16
+ }): Promise<{
17
+ entries: ReadonlyArray<{
18
+ key: string;
19
+ value: unknown;
20
+ }>;
21
+ next?: string;
22
+ }>;
23
+ }
24
+ export declare function configureNativeStateStorage(storage: NativeStateStorage | undefined): void;
25
+ /** Prune state as stored on disk */
26
+ export interface PersistedPruneMessagesState {
27
+ byMessageId: Record<string, PrunedMessageEntry>;
28
+ blocksById: Record<string, CompressionBlock>;
29
+ activeBlockIds: number[];
30
+ activeByAnchorMessageId: Record<string, number>;
31
+ nextBlockId: number;
32
+ nextRunId: number;
33
+ markedForCleanup?: number[];
34
+ }
35
+ export interface PersistedPrune {
36
+ tools?: Record<string, number>;
37
+ messages?: PersistedPruneMessagesState;
38
+ }
39
+ export interface PersistedNudges {
40
+ contextLimitAnchors: string[];
41
+ turnNudgeAnchors?: string[];
42
+ iterationNudgeAnchors?: string[];
43
+ lastPerMessageNudgeTurn?: number;
44
+ lastPerMessageNudgeTokens?: number;
45
+ lastNudgeShownTokens?: number;
46
+ lastToolOutputNudgeTokens?: number;
47
+ lastTier2NudgeTokens?: number;
48
+ lastTier3NudgeTokens?: number;
49
+ /** @deprecated use lastTier2NudgeTokens — migrated on load */
50
+ lastTierNudgeTokens?: number;
51
+ compressBaselineSet?: boolean;
52
+ }
53
+ export interface PersistedMessageIds {
54
+ byRawId: Record<string, string>;
55
+ byRef: Record<string, string>;
56
+ nextRef: number;
57
+ }
58
+ export interface PersistedSessionState {
59
+ sessionName?: string;
60
+ prune: PersistedPrune;
61
+ nudges: PersistedNudges;
62
+ stats: SessionStats;
63
+ lastUpdated: string;
64
+ messageIds?: PersistedMessageIds;
65
+ lastCompaction?: number;
66
+ modelContextLimit?: number;
67
+ modelProviderID?: string;
68
+ modelID?: string;
69
+ /** [Issue #478] Archived image metadata index (raw message ID → entries) */
70
+ imageArchive?: Record<string, ArchivedImageEntry[]>;
71
+ /** [Issue #485] Sticky emergency truncations (tool call ID → frozen truncated output) */
72
+ stickyTruncations?: Record<string, string>;
73
+ }
74
+ /** Default storage directory: $XDG_DATA_HOME/opencode/storage/plugin/acp */
75
+ export declare function getDefaultStorageDir(): string;
76
+ /**
77
+ * Resolve the configured `storagePath` to an absolute directory.
78
+ * - undefined/empty → default location
79
+ * - `~` or `~/...` → expanded against the home directory
80
+ * - absolute → used as-is
81
+ * - relative → resolved against `projectDir` (opencode's working directory)
82
+ */
83
+ export declare function resolveStorageDir(configured: string | undefined, projectDir: string): string;
84
+ export declare function saveSessionState(sessionState: SessionState, logger: Logger, sessionName?: string): Promise<void>;
85
+ export declare function loadSessionState(sessionId: string, logger: Logger, storageDir?: string): Promise<PersistedSessionState | null>;
86
+ export interface AggregatedStats {
87
+ totalTokens: number;
88
+ totalTools: number;
89
+ totalMessages: number;
90
+ sessionCount: number;
91
+ }
92
+ export declare function loadAllSessionStats(logger: Logger, storageDir?: string): Promise<AggregatedStats>;
93
+ //# sourceMappingURL=persistence.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../src/state/persistence.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,40 @@
1
+ /**
2
+ * Fork-recovery: reconstruct ACP compression state from message history.
3
+ *
4
+ * When a session is forked, OpenCode copies all messages (including completed
5
+ * `compress` tool parts) but regenerates message IDs. ACP's persisted state is
6
+ * keyed off the original session ID and original raw message IDs, so the fork
7
+ * session starts with empty prune state → no pruning → context overflow.
8
+ *
9
+ * This module replays historical `compress` tool invocations in chronological
10
+ * order, rebuilding `CompressionBlock`s / `byMessageId` / `activeByAnchorMessageId`
11
+ * using the fork's NEW raw IDs. Because message refs (mNNNNN) are assigned
12
+ * sequentially by message order, they are fork-stable: a ref in a compress
13
+ * input points to the same logical message in both original and fork.
14
+ *
15
+ * The rebuilt state is an approximation: protected-content enrichments that
16
+ * were appended to summaries at original-compress-time are not re-derived
17
+ * (only the raw model summary from the tool input is available). This is
18
+ * acceptable — protected tool outputs survive in visible context anyway, and
19
+ * the primary goal (pruning compressed messages to avoid overflow) is met.
20
+ */
21
+ import type { PluginConfig } from "../config";
22
+ import type { Logger } from "../logger";
23
+ import type { PersistedSessionState } from "./persistence";
24
+ import type { SessionState, WithParts } from "./types";
25
+ /**
26
+ * Restore pre-fork compression blocks from the parent state when the fork's
27
+ * copied history no longer includes replayable compress inputs. This is
28
+ * intentionally all-or-nothing for active blocks: an uncertain mapping falls
29
+ * back to normal history replay instead of risking an incorrect prune.
30
+ */
31
+ export declare function restoreForkCompressionState(state: SessionState, forkMessages: WithParts[], parent: PersistedSessionState, parentMessages: WithParts[], logger: Logger): number;
32
+ /**
33
+ * Reconstruct compression state by replaying historical `compress` tool
34
+ * invocations from message history. Called when no persisted state exists
35
+ * (fork scenario).
36
+ *
37
+ * @returns number of compression blocks reconstructed.
38
+ */
39
+ export declare function rebuildCompressionState(state: SessionState, messages: WithParts[], config: PluginConfig, logger: Logger): number;
40
+ //# sourceMappingURL=rebuild.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rebuild.d.ts","sourceRoot":"","sources":["../../src/state/rebuild.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAY,YAAY,EAAE,MAAM,WAAW,CAAA;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAkBvC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAW1D,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAqJtD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACvC,KAAK,EAAE,YAAY,EACnB,YAAY,EAAE,SAAS,EAAE,EACzB,MAAM,EAAE,qBAAqB,EAC7B,cAAc,EAAE,SAAS,EAAE,EAC3B,MAAM,EAAE,MAAM,GACf,MAAM,CA6FR;AAyKD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACnC,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,SAAS,EAAE,EACrB,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,GACf,MAAM,CAuDR"}
@@ -0,0 +1,36 @@
1
+ import type { SessionState, WithParts } from "./types";
2
+ import type { PluginConfig } from "../config";
3
+ import type { Logger } from "../logger";
4
+ import { type CompressionTimingState } from "../compress/timing";
5
+ /**
6
+ * Per-turn state update (compaction detection + turn count). Extracted from the
7
+ * old `checkSession`; session-switch + init now live in SessionStateRegistry.
8
+ */
9
+ export declare function updatePerTurnState(state: SessionState, logger: Logger, messages: WithParts[]): Promise<void>;
10
+ export declare class SessionStateRegistry {
11
+ private readonly logger;
12
+ private readonly projectDir?;
13
+ private readonly states;
14
+ readonly compressionTiming: CompressionTimingState;
15
+ private readonly catalog;
16
+ constructor(logger: Logger, projectDir?: string | undefined);
17
+ recordModelLimit(providerId: string | undefined, modelId: string | undefined, limit: number | undefined): void;
18
+ resolveModelLimit(providerId: string | undefined, modelId: string | undefined): number | undefined;
19
+ /**
20
+ * Best-effort one-time seed from the host's provider catalog
21
+ * V2 model catalog. Never throws; returns the number of model-limit entries recorded.
22
+ * returns the number of model-limit entries recorded.
23
+ */
24
+ hydrateModelLimitsFromClient(client: unknown): Promise<number>;
25
+ private lazyHydration;
26
+ hydrateAndResolve(client: unknown, providerId: string, modelId: string): Promise<number | undefined>;
27
+ get(sessionId: string): SessionState | undefined;
28
+ all(): SessionState[];
29
+ get size(): number;
30
+ getOrCreate(client: any, sessionId: string, messages: WithParts[], config?: PluginConfig): Promise<SessionState>;
31
+ private enforceSoftCap;
32
+ }
33
+ export declare function createSessionState(): SessionState;
34
+ export declare function resetSessionState(state: SessionState): void;
35
+ export declare function ensureSessionInitialized(client: any, state: SessionState, sessionId: string, logger: Logger, messages: WithParts[], config?: PluginConfig, projectDir?: string): Promise<void>;
36
+ //# sourceMappingURL=state.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/state/state.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAsB,YAAY,EAAsB,SAAS,EAAE,MAAM,SAAS,CAAA;AAC9F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,EAEH,KAAK,sBAAsB,EAE9B,MAAM,oBAAoB,CAAA;AAqB3B;;;GAGG;AACH,wBAAsB,kBAAkB,CACpC,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,SAAS,EAAE,GACtB,OAAO,CAAC,IAAI,CAAC,CAiBf;AAkBD,qBAAa,oBAAoB;IAezB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAfhC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IACzD,QAAQ,CAAC,iBAAiB,EAAE,sBAAsB,CAGjD;IAOD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;gBAG/B,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,YAAA;IAGxC,gBAAgB,CACZ,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,KAAK,EAAE,MAAM,GAAG,SAAS,GAC1B,IAAI;IAIP,iBAAiB,CACb,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,MAAM,GAAG,SAAS,GAC5B,MAAM,GAAG,SAAS;IAIrB;;;;OAIG;IACH,4BAA4B,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAY9D,OAAO,CAAC,aAAa,CAA6B;IAE5C,iBAAiB,CACnB,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAU9B,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIhD,GAAG,IAAI,YAAY,EAAE;IAIrB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAKK,WAAW,CACb,MAAM,EAAE,GAAG,EACX,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,SAAS,EAAE,EACrB,MAAM,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,YAAY,CAAC;IA4BxB,OAAO,CAAC,cAAc;CAWzB;AAED,wBAAgB,kBAAkB,IAAI,YAAY,CAkDjD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CA4C3D;AAED,wBAAsB,wBAAwB,CAC1C,MAAM,EAAE,GAAG,EACX,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,SAAS,EAAE,EACrB,MAAM,CAAC,EAAE,YAAY,EACrB,UAAU,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAiMf"}
@@ -0,0 +1,13 @@
1
+ import type { SessionState, WithParts } from "./index";
2
+ import type { Logger } from "../logger";
3
+ import { PluginConfig } from "../config";
4
+ /**
5
+ * Sync tool parameters from session messages.
6
+ */
7
+ export declare function syncToolCache(state: SessionState, config: PluginConfig, logger: Logger, messages: WithParts[]): void;
8
+ /**
9
+ * Trim the tool parameters cache to prevent unbounded memory growth.
10
+ * Uses FIFO eviction - removes oldest entries first.
11
+ */
12
+ export declare function trimToolParametersCache(state: SessionState): void;
13
+ //# sourceMappingURL=tool-cache.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-cache.d.ts","sourceRoot":"","sources":["../../src/state/tool-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAc,SAAS,EAAE,MAAM,SAAS,CAAA;AAClE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAMxC;;GAEG;AACH,wBAAgB,aAAa,CACzB,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,SAAS,EAAE,GACtB,IAAI,CAwDN;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAajE"}
@@ -0,0 +1,221 @@
1
+ import type { CompressionTimingState } from "../compress/timing";
2
+ import type { Message, Part } from "./message-types";
3
+ export interface WithParts {
4
+ info: Message;
5
+ parts: Part[];
6
+ }
7
+ export type ToolStatus = "pending" | "running" | "completed" | "error";
8
+ export interface ToolParameterEntry {
9
+ tool: string;
10
+ parameters: any;
11
+ status?: ToolStatus;
12
+ error?: string;
13
+ turn: number;
14
+ tokenCount?: number;
15
+ }
16
+ export interface SessionStats {
17
+ pruneTokenCounter: number;
18
+ totalPruneTokens: number;
19
+ /** [Issue #478] Count of image files written to the session archive (cumulative). */
20
+ imagesArchived?: number;
21
+ /** [Issue #478] Total bytes of archived images (cumulative). */
22
+ imageBytesArchived?: number;
23
+ }
24
+ /**
25
+ * [Issue #478] Metadata for one archived session image. Pixels live on disk;
26
+ * only this record persists in state (no base64 in memory or on disk state).
27
+ */
28
+ export interface ArchivedImageEntry {
29
+ path: string;
30
+ mediaType: string;
31
+ bytes: number;
32
+ }
33
+ export interface PrunedMessageEntry {
34
+ tokenCount: number;
35
+ allBlockIds: number[];
36
+ activeBlockIds: number[];
37
+ }
38
+ export type CompressionMode = "range" | "message";
39
+ export type BlockGeneration = "young" | "old";
40
+ export type CompressionTier = 1 | 2 | 3;
41
+ export interface CompressionBlock {
42
+ blockId: number;
43
+ runId: number;
44
+ active: boolean;
45
+ deactivatedByUser: boolean;
46
+ deactivatedByUserDeep?: boolean;
47
+ compressedTokens: number;
48
+ /**
49
+ * Total tokens this block represents, including tokens from consumed
50
+ * blocks. For tier 1 blocks: equals compressedTokens. For tier 2+:
51
+ * compressedTokens + sum of consumed blocks' effectiveCompressedTokens.
52
+ * Undefined on old state files — callers should fall back to compressedTokens.
53
+ */
54
+ effectiveCompressedTokens?: number;
55
+ summaryTokens: number;
56
+ durationMs: number;
57
+ mode?: CompressionMode;
58
+ tier?: CompressionTier;
59
+ topic: string;
60
+ batchTopic?: string;
61
+ startId: string;
62
+ endId: string;
63
+ anchorMessageId: string;
64
+ compressMessageId: string;
65
+ compressCallId?: string;
66
+ includedBlockIds: number[];
67
+ consumedBlockIds: number[];
68
+ parentBlockIds: number[];
69
+ directMessageIds: string[];
70
+ directToolIds: string[];
71
+ effectiveMessageIds: string[];
72
+ effectiveToolIds: string[];
73
+ createdAt: number;
74
+ deactivatedAt?: number;
75
+ deactivatedByBlockId?: number;
76
+ summary: string;
77
+ survivedCount: number;
78
+ generation?: BlockGeneration;
79
+ }
80
+ export interface PruneMessagesState {
81
+ byMessageId: Map<string, PrunedMessageEntry>;
82
+ blocksById: Map<number, CompressionBlock>;
83
+ activeBlockIds: Set<number>;
84
+ activeByAnchorMessageId: Map<string, number>;
85
+ nextBlockId: number;
86
+ nextRunId: number;
87
+ markedForCleanup: Set<number>;
88
+ /** Transient: persisted memberships need one repair sync before fast-path reuse. */
89
+ membershipsVerified: boolean;
90
+ /**
91
+ * [Issue #384] Transient fields below are NEVER persisted — serialization
92
+ * (serializePruneMessagesState / PersistedSessionState) lists fields
93
+ * explicitly, so they survive only within one process lifetime.
94
+ *
95
+ * structureVersion: monotonically increasing counter bumped by every
96
+ * block-structure/liveness mutation (applyCompressionState, merge, user
97
+ * decompress). syncCompressionBlocks uses it to skip the full replay over
98
+ * all historical blocks when nothing changed since the last sync.
99
+ */
100
+ structureVersion?: number;
101
+ /** structureVersion at which the last sync (full or incremental) ran. */
102
+ lastSyncedStructureVersion?: number;
103
+ /**
104
+ * Cached consumed-call indexes for hideConsumedCompressCalls. Depends only
105
+ * on block liveness, so it is keyed by structureVersion.
106
+ */
107
+ hideConsumedIndex?: {
108
+ version: number;
109
+ allBlockCallIds: Set<string>;
110
+ liveRangeKeysByCallId: Map<string, Set<string>>;
111
+ activeCallIds: Set<string>;
112
+ };
113
+ }
114
+ export interface Prune {
115
+ messages: PruneMessagesState;
116
+ }
117
+ export interface MessageIdState {
118
+ byRawId: Map<string, string>;
119
+ byRef: Map<string, string>;
120
+ nextRef: number;
121
+ }
122
+ export interface Nudges {
123
+ contextLimitAnchors: Set<string>;
124
+ turnNudgeAnchors: Set<string>;
125
+ iterationNudgeAnchors: Set<string>;
126
+ lastPerMessageNudgeTurn: number;
127
+ lastPerMessageNudgeTokens: number | undefined;
128
+ lastNudgeShownTokens: number | undefined;
129
+ lastToolOutputNudgeTokens: number | undefined;
130
+ lastTier2NudgeTokens: number | undefined;
131
+ lastTier3NudgeTokens: number | undefined;
132
+ /** Set by injectCompressNudges; read by system prompt handler next turn (1-turn lag). Undefined = first turn. */
133
+ shouldInjectThisTurn: boolean | undefined;
134
+ /**
135
+ * Lock flag: prevents baseline leak after compress.
136
+ *
137
+ * When compress is detected in the current turn, the baseline is set to
138
+ * currentTokens ONLY on the first transform (before continuation work
139
+ * inflates it). Subsequent transforms in the same turn skip the update.
140
+ * Reset to false when compress is NOT in the current turn.
141
+ */
142
+ compressBaselineSet: boolean;
143
+ /**
144
+ * Tracks the message ID of the last processed compress call.
145
+ *
146
+ * Prevents the early-return in injectCompressNudges from firing repeatedly
147
+ * for the SAME compress call. In autonomous sessions (single user message),
148
+ * a compress stays in the turn forever — without this tracking, the nudge
149
+ * system would NEVER evaluate again after the first compress.
150
+ *
151
+ * NOT persisted — transient by design. On restart it's undefined, causing
152
+ * one extra early-return on the first call, then normal behavior resumes.
153
+ */
154
+ lastProcessedCompressMessageId: string | undefined;
155
+ }
156
+ export interface SessionState {
157
+ sessionId: string | null;
158
+ isSubAgent: boolean;
159
+ compressPermission: "ask" | "allow" | "deny" | undefined;
160
+ prune: Prune;
161
+ nudges: Nudges;
162
+ stats: SessionStats;
163
+ compressionTiming: CompressionTimingState;
164
+ toolParameters: Map<string, ToolParameterEntry>;
165
+ toolIdList: string[];
166
+ messageIds: MessageIdState;
167
+ lastCompaction: number;
168
+ currentTurn: number;
169
+ modelContextLimit: number | undefined;
170
+ /** [FIX #312 follow-up] Identity of the model `modelContextLimit` was recorded for. Written together with the limit by the system hook; lets the messages hook detect a stale limit when the catalog misses. */
171
+ modelProviderID: string | undefined;
172
+ modelID: string | undefined;
173
+ systemPromptTokens: number | undefined;
174
+ /**
175
+ * Resolved directory for this session's persisted state file (absolute path).
176
+ * Transient (NOT persisted): resolved once per session from config.storagePath
177
+ * in ensureSessionInitialized. Undefined → default XDG location.
178
+ */
179
+ storageDir: string | undefined;
180
+ /**
181
+ * Transient flag (NOT persisted): set to true when a compress call is rejected
182
+ * by the pre-commit quality gate. The model must retry with `acknowledgeRisk: true`
183
+ * to bypass quality on the retry. Consumed (reset to false) on use.
184
+ *
185
+ * Lifecycle:
186
+ * - Quality fails → flag = true → rejection error returned
187
+ * - Retry with acknowledgeRisk:true + flag=true → accepted, flag = false
188
+ * - acknowledgeRisk:true + flag=false → IGNORED (no-op): quality runs
189
+ * normally, result carries an "acknowledgeRisk was ignored" note (#301)
190
+ * - Normal call (no acknowledgeRisk) → quality runs normally
191
+ */
192
+ qualityGateRetryPending: boolean;
193
+ /**
194
+ * Transient flag (NOT persisted): set to true after the "model reports no
195
+ * context window" warning has been emitted for this session, so the
196
+ * warning fires at most once per session per process.
197
+ */
198
+ noContextLimitWarned: boolean;
199
+ /**
200
+ * [Issue #478] Metadata index of archived session images, keyed by RAW
201
+ * message ID. Raw IDs are stable across compaction ref re-issues, so the
202
+ * archived paths stay valid even when mNNNNN refs restart. Persisted.
203
+ */
204
+ imageArchive: Record<string, ArchivedImageEntry[]>;
205
+ /**
206
+ * [Issue #478] Transient flag (NOT persisted): TTL housekeeping of the
207
+ * image archive directory has run for this session in this process.
208
+ */
209
+ imagePruneDone: boolean;
210
+ /**
211
+ * [Issue #485] Sticky emergency truncations: tool call ID → the truncated
212
+ * output the guards last produced. Written when
213
+ * `compress.emergencyTruncation` is on and a guard truncates/clears a tool
214
+ * output; replayed verbatim on every later request so the decision is
215
+ * one-way (A→B→B→…) instead of oscillating back to the pristine output.
216
+ * Entries are pruned when their call disappears from the session.
217
+ * Persisted so stickiness survives restarts.
218
+ */
219
+ stickyTruncations: Record<string, string>;
220
+ }
221
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/state/types.ts"],"names":[],"mappings":"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"}