@casualjim/pi-headroom 0.1.1

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.
@@ -0,0 +1,119 @@
1
+ import type { ContextEvent } from "@earendil-works/pi-coding-agent";
2
+
3
+ // AgentMessage lives in @earendil-works/pi-agent-core, which is only a transitive
4
+ // dependency here. Derive it from the publicly exported ContextEvent payload so the
5
+ // package depends solely on @earendil-works/pi-coding-agent + @earendil-works/pi-ai.
6
+ export type AgentMessage = ContextEvent["messages"][number];
7
+
8
+ export interface TextContentPart {
9
+ type: "text";
10
+ text: string;
11
+ }
12
+
13
+ export interface ImageContentPart {
14
+ type: "image_url";
15
+ image_url: { url: string; detail?: "auto" | "low" | "high" };
16
+ }
17
+
18
+ export type OpenAIContentPart = TextContentPart | ImageContentPart;
19
+
20
+ export interface OpenAISystemMessage {
21
+ role: "system";
22
+ content: string;
23
+ }
24
+
25
+ export interface OpenAIUserMessage {
26
+ role: "user";
27
+ content: string | OpenAIContentPart[];
28
+ }
29
+
30
+ export interface OpenAIToolCall {
31
+ id: string;
32
+ type: "function";
33
+ function: { name: string; arguments: string };
34
+ }
35
+
36
+ export interface OpenAIAssistantMessage {
37
+ role: "assistant";
38
+ content: string | null;
39
+ tool_calls?: OpenAIToolCall[];
40
+ }
41
+
42
+ export interface OpenAIToolMessage {
43
+ role: "tool";
44
+ content: string;
45
+ tool_call_id: string;
46
+ }
47
+
48
+ export type OpenAIMessage = OpenAISystemMessage | OpenAIUserMessage | OpenAIAssistantMessage | OpenAIToolMessage;
49
+
50
+ export interface CompressResult {
51
+ messages: OpenAIMessage[];
52
+ tokensBefore: number;
53
+ tokensAfter: number;
54
+ tokensSaved: number;
55
+ compressionRatio: number;
56
+ transformsApplied: string[];
57
+ ccrHashes: string[];
58
+ compressed: boolean;
59
+ }
60
+
61
+ export type HeadroomMode = "normal" | "quiet" | "silent";
62
+
63
+ export interface HeadroomConfig {
64
+ enabled: boolean;
65
+ baseUrl: string;
66
+ allowRemote: boolean;
67
+ renameToolCalls: boolean;
68
+ mode: HeadroomMode;
69
+ minContextTokens: number;
70
+ minMessageChars: number;
71
+ timeoutMs: number;
72
+ }
73
+
74
+ export interface HeadroomStats {
75
+ attempts: number;
76
+ applied: number;
77
+ guardSkips: number;
78
+ tokensSaved: number;
79
+ last?: {
80
+ tokensBefore: number;
81
+ tokensAfter: number;
82
+ tokensSaved: number;
83
+ compressionRatio: number;
84
+ transformsApplied: string[];
85
+ ccrHashes: string[];
86
+ appliedMessages: number;
87
+ };
88
+ lastError?: string;
89
+ lastSkipReason?: string;
90
+ }
91
+
92
+ export interface CompressionMapping {
93
+ sourceIndex: number;
94
+ message: OpenAIMessage;
95
+ applyTo: "toolResult" | null;
96
+ originalText: string;
97
+ }
98
+
99
+ export interface CompressionPayload {
100
+ messages: OpenAIMessage[];
101
+ mappings: CompressionMapping[];
102
+ candidateCount: number;
103
+ }
104
+
105
+ export interface ApplyCompressionOptions {
106
+ minMessageChars: number;
107
+ }
108
+
109
+ export type ApplyCompressionResult =
110
+ | {
111
+ ok: true;
112
+ messages: AgentMessage[];
113
+ appliedMessages: number;
114
+ appliedTokensBefore: number;
115
+ appliedTokensAfter: number;
116
+ appliedTokensSaved: number;
117
+ appliedCompressionRatio: number;
118
+ }
119
+ | { ok: false; reason: string };
package/package.json ADDED
@@ -0,0 +1,58 @@
1
+ {
2
+ "name": "@casualjim/pi-headroom",
3
+ "version": "0.1.1",
4
+ "description": "Headroom context compression for pi with a working headroom_retrieve tool",
5
+ "keywords": [
6
+ "pi-package",
7
+ "headroom",
8
+ "context-compression"
9
+ ],
10
+ "license": "MIT",
11
+ "author": "casualjim",
12
+ "repository": {
13
+ "type": "git",
14
+ "url": "https://github.com/casualjim/pi-mimir"
15
+ },
16
+ "type": "module",
17
+ "files": [
18
+ "extensions/",
19
+ "README.md",
20
+ "LICENSE"
21
+ ],
22
+ "engines": {
23
+ "node": ">=22.0.0"
24
+ },
25
+ "publishConfig": {
26
+ "access": "public"
27
+ },
28
+ "scripts": {
29
+ "typecheck": "tsc --noEmit",
30
+ "check:pack": "pnpm pack --dry-run",
31
+ "test": "vitest run"
32
+ },
33
+ "pi": {
34
+ "extensions": [
35
+ "./extensions/headroom.ts"
36
+ ]
37
+ },
38
+ "omp": {
39
+ "extensions": [
40
+ "./extensions/headroom.ts"
41
+ ]
42
+ },
43
+ "peerDependencies": {
44
+ "@earendil-works/pi-ai": "*",
45
+ "@earendil-works/pi-coding-agent": "*",
46
+ "@earendil-works/pi-tui": "*",
47
+ "typebox": "*"
48
+ },
49
+ "devDependencies": {
50
+ "@earendil-works/pi-ai": "^0.87.1",
51
+ "@earendil-works/pi-coding-agent": "^0.87.1",
52
+ "@earendil-works/pi-tui": "^0.87.0",
53
+ "@types/node": "^24.13.4",
54
+ "typebox": "^1.3.30",
55
+ "typescript": "^7.0.2",
56
+ "vitest": "^5.0.0"
57
+ }
58
+ }