@narumitw/pi-herdr 0.1.1 → 0.3.0

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.
@@ -1,13 +1,7 @@
1
1
  import { sanitizeTerminalText } from "@narumitw/pi-tui-kit/terminal-text";
2
2
  import type { HerdrRequest } from "./herdr-client.js";
3
3
 
4
- export const HERDR_METADATA_TOKEN_KEYS = [
5
- "model",
6
- "provider",
7
- "thinking",
8
- "session",
9
- "context_usage",
10
- ] as const;
4
+ export const HERDR_METADATA_TOKEN_KEYS = ["model", "provider", "thinking", "session", "context_usage"] as const;
11
5
 
12
6
  export type HerdrMetadataTokenKey = (typeof HERDR_METADATA_TOKEN_KEYS)[number];
13
7
  export type HerdrMetadataSnapshot = Readonly<Record<HerdrMetadataTokenKey, string | null>>;
@@ -17,71 +11,71 @@ export const HERDR_METADATA_TTL_MS = 60 * 60 * 1000;
17
11
  export const HERDR_METADATA_REFRESH_MS = 30 * 60 * 1000;
18
12
 
19
13
  export interface HerdrMetadataInputs {
20
- model?: unknown;
21
- provider?: unknown;
22
- thinking?: unknown;
23
- session?: unknown;
24
- contextUsagePercent?: unknown;
14
+ model?: unknown;
15
+ provider?: unknown;
16
+ thinking?: unknown;
17
+ session?: unknown;
18
+ contextUsagePercent?: unknown;
25
19
  }
26
20
 
27
21
  export interface HerdrMetadataRequestOptions {
28
- id: string;
29
- paneId: string;
30
- source: string;
31
- seq: number;
32
- snapshot: HerdrMetadataSnapshot;
33
- ttlMs?: number;
22
+ id: string;
23
+ paneId: string;
24
+ source: string;
25
+ seq: number;
26
+ snapshot: HerdrMetadataSnapshot;
27
+ ttlMs?: number;
34
28
  }
35
29
 
36
30
  export function normalizeHerdrMetadataValue(value: unknown): string | null {
37
- if (typeof value !== "string") return null;
38
- const normalized = sanitizeTerminalText(value).trim();
39
- if (normalized.length === 0) return null;
40
- return [...normalized].slice(0, HERDR_METADATA_MAX_CHARACTERS).join("");
31
+ if (typeof value !== "string") return null;
32
+ const normalized = sanitizeTerminalText(value).trim();
33
+ if (normalized.length === 0) return null;
34
+ return [...normalized].slice(0, HERDR_METADATA_MAX_CHARACTERS).join("");
41
35
  }
42
36
 
43
37
  export function formatContextUsagePercent(value: unknown): string | null {
44
- if (typeof value !== "number" || !Number.isFinite(value) || value < 0) return null;
45
- return `${Math.round(value)}%`;
38
+ if (typeof value !== "number" || !Number.isFinite(value) || value < 0) return null;
39
+ return `${Math.round(value)}%`;
46
40
  }
47
41
 
48
42
  export function createHerdrMetadataSnapshot(inputs: HerdrMetadataInputs): HerdrMetadataSnapshot {
49
- return Object.freeze({
50
- model: normalizeHerdrMetadataValue(inputs.model),
51
- provider: normalizeHerdrMetadataValue(inputs.provider),
52
- thinking: normalizeHerdrMetadataValue(inputs.thinking),
53
- session: normalizeHerdrMetadataValue(inputs.session),
54
- context_usage: formatContextUsagePercent(inputs.contextUsagePercent),
55
- });
43
+ return Object.freeze({
44
+ model: normalizeHerdrMetadataValue(inputs.model),
45
+ provider: normalizeHerdrMetadataValue(inputs.provider),
46
+ thinking: normalizeHerdrMetadataValue(inputs.thinking),
47
+ session: normalizeHerdrMetadataValue(inputs.session),
48
+ context_usage: formatContextUsagePercent(inputs.contextUsagePercent),
49
+ });
56
50
  }
57
51
 
58
52
  export function createHerdrMetadataClearSnapshot(): HerdrMetadataSnapshot {
59
- return Object.freeze({
60
- model: null,
61
- provider: null,
62
- thinking: null,
63
- session: null,
64
- context_usage: null,
65
- });
53
+ return Object.freeze({
54
+ model: null,
55
+ provider: null,
56
+ thinking: null,
57
+ session: null,
58
+ context_usage: null,
59
+ });
66
60
  }
67
61
 
68
62
  export function herdrMetadataSnapshotsEqual(
69
- left: HerdrMetadataSnapshot | undefined,
70
- right: HerdrMetadataSnapshot,
63
+ left: HerdrMetadataSnapshot | undefined,
64
+ right: HerdrMetadataSnapshot,
71
65
  ): boolean {
72
- return left !== undefined && HERDR_METADATA_TOKEN_KEYS.every((key) => left[key] === right[key]);
66
+ return left !== undefined && HERDR_METADATA_TOKEN_KEYS.every((key) => left[key] === right[key]);
73
67
  }
74
68
 
75
69
  export function createHerdrMetadataRequest(options: HerdrMetadataRequestOptions): HerdrRequest {
76
- return {
77
- id: options.id,
78
- method: "pane.report_metadata",
79
- params: {
80
- pane_id: options.paneId,
81
- source: options.source,
82
- seq: options.seq,
83
- tokens: { ...options.snapshot },
84
- ttl_ms: options.ttlMs ?? HERDR_METADATA_TTL_MS,
85
- },
86
- };
70
+ return {
71
+ id: options.id,
72
+ method: "pane.report_metadata",
73
+ params: {
74
+ pane_id: options.paneId,
75
+ source: options.source,
76
+ seq: options.seq,
77
+ tokens: { ...options.snapshot },
78
+ ttl_ms: options.ttlMs ?? HERDR_METADATA_TTL_MS,
79
+ },
80
+ };
87
81
  }