harnery 0.34.1 → 0.36.0

package/dist/core/hooks/adapter/runtime-telemetry.d.ts

@@ -0,0 +1,142 @@
+import type { Adapter } from "../../adapter.js";
+export type RuntimeContextTelemetry = {
+    state: "observed";
+    used_tokens: number;
+    limit_tokens: number;
+    measured_at: string;
+    method: "codex_transcript_token_count" | "claude_transcript_usage_model_capability";
+    source_event: string;
+    source_witness: string;
+    attestation: "derived" | "inferred";
+    confidence: "exact" | "high" | "medium";
+    bytes_read: number;
+    io_duration_ms: number;
+} | {
+    state: "observed";
+    used_percent: number;
+    measured_at: string;
+    method: "cursor_composer_context_percent";
+    source_event: string;
+    source_witness: string;
+    attestation: "derived";
+    confidence: "high";
+    runtime_version?: string;
+    bytes_read: number;
+    io_duration_ms: number;
+} | {
+    state: "partial";
+    reason: RuntimeContextMissingReason;
+    used_tokens?: number;
+    measured_at?: string;
+    bytes_read: number;
+    io_duration_ms: number;
+} | {
+    state: "unsupported";
+    reason: RuntimeContextUnsupportedReason;
+    bytes_read: 0;
+    io_duration_ms: number;
+};
+export type RuntimeContextMissingReason = "codex_transcript_ambiguous" | "codex_transcript_session_mismatch" | "codex_transcript_unreadable" | "codex_transcript_turn_not_found" | "codex_transcript_turn_not_terminal" | "codex_transcript_token_count_missing" | "codex_transcript_sample_stale" | "context_used_tokens_not_reported" | "context_limit_tokens_not_reported" | "context_limit_tokens_invalid" | "claude_context_limit_tokens_not_reported" | "claude_transcript_sample_stale" | "claude_transcript_session_mismatch" | "claude_transcript_turn_not_found" | "claude_transcript_unreadable" | "cursor_context_database_unavailable" | "cursor_context_database_unreadable" | "cursor_context_session_not_found" | "cursor_context_sample_ambiguous" | "cursor_context_sample_stale" | "cursor_context_sample_time_not_reported" | "cursor_context_usage_invalid";
+export type RuntimeContextUnsupportedReason = "runtime_context_telemetry_unavailable" | "runtime_session_id_not_reported" | "runtime_turn_id_not_reported" | "runtime_adapter_not_supported";
+export interface RuntimeContextRequest {
+    adapter: Adapter;
+    session_id?: string;
+    turn_id?: string;
+    /** Canonical producer turn boundary used when task_started has left the bounded tail. */
+    turn_started_at?: string;
+    transcript_path?: string;
+    observed_at?: string;
+    /**
+     * Status reads the newest session sample without turn attribution. Active
+     * turn reads require a matching task_started boundary but not task_complete.
+     */
+    mode: "turn" | "active_turn" | "status";
+}
+export interface RuntimeTelemetryOptions {
+    codexRoots?: string[];
+    cursorRoots?: string[];
+    maxCursorDatabases?: number;
+    maxTailBytes?: number;
+    maxSampleAgeMs?: number;
+    /** Recorder-only cadence override used by deterministic tests. */
+    activeContextProbeIntervalMs?: number;
+}
+/**
+ * Read privacy-safe context telemetry from a local runtime transcript.
+ *
+ * The returned union contains only numeric measurements, timestamps, bounded
+ * I/O counters, and a privacy-safe witness. Transcript bodies and paths never
+ * cross this interface.
+ */
+export declare function readRuntimeContextTelemetry(request: RuntimeContextRequest, options?: RuntimeTelemetryOptions): RuntimeContextTelemetry;
+/**
+ * Locate a Codex rollout transcript for a session when the hook payload
+ * carries no transcript_path. Codex omits the path on its hook events, which
+ * leaves transcript-backed evidence unavailable unless Harnery resolves the
+ * rollout itself. Discovery reuses the telemetry scanner's roots (native
+ * ~/.codex plus WSL-mounted Windows homes) and its process cache, and returns
+ * undefined on zero or ambiguous matches.
+ *
+ * Callers on repeated hook paths must retain the verified result in their
+ * owner-only session state. The process cache bounds repeated reads inside one
+ * process, but hook processes are intentionally short-lived.
+ */
+export declare function discoverCodexSessionTranscript(sessionId: string | undefined, transcriptPath?: string, options?: RuntimeTelemetryOptions): string | undefined;
+/** Status compatibility wrapper: exact pairs render; partial values do not. */
+export declare function readRuntimeContextUsage(adapter: Adapter, sessionId: string, options?: RuntimeTelemetryOptions): {
+    used: number;
+    window: number;
+} | null;
+export declare function clearRuntimeTelemetryCachesForTest(): void;
+export type RuntimeTuningMissingReason = "codex_transcript_ambiguous" | "codex_transcript_session_mismatch" | "codex_transcript_unreadable" | "codex_transcript_turn_context_missing" | "claude_transcript_unreadable" | "claude_transcript_assistant_row_missing";
+/**
+ * Privacy-safe tuning identity read from a local runtime transcript.
+ *
+ * `observed` means the newest identity-bearing row was read: a Codex
+ * `turn_context` row or a CC assistant row with a real model id. An observed
+ * result with NO `effort` is itself evidence — CC omits the field exactly when
+ * the model has no effort dial — so callers must distinguish it from
+ * `partial`/`unsupported`, where nothing was established.
+ */
+export type RuntimeTuningTelemetry = {
+    state: "observed";
+    model?: string;
+    effort?: string;
+    speed?: string;
+    measured_at?: string;
+    method: "codex_transcript_turn_context" | "claude_transcript_assistant_row";
+    source_event: string;
+    bytes_read: number;
+    io_duration_ms: number;
+} | {
+    state: "partial";
+    reason: RuntimeTuningMissingReason;
+    bytes_read: number;
+    io_duration_ms: number;
+} | {
+    state: "unsupported";
+    reason: RuntimeContextUnsupportedReason;
+    bytes_read: 0;
+    io_duration_ms: number;
+};
+export interface RuntimeTuningRequest {
+    adapter: Adapter;
+    session_id?: string;
+    transcript_path?: string;
+}
+/**
+ * Read the newest observed tuning (effort, and speed where reported) for a
+ * session from its local runtime transcript.
+ *
+ * Codex: the newest `turn_context` row carries the EFFECTIVE per-turn effort,
+ * including `-c model_reasoning_effort` overrides (the config default is
+ * deliberately not consulted — it is the default, not the effective value).
+ * CC: the newest assistant row carries effort at the row's top level and
+ * speed inside `message.usage`; model, effort, and speed are read from the
+ * SAME row so a mid-session model swap cannot blend two rows' values.
+ *
+ * Same bounded tail-read and privacy posture as `readRuntimeContextTelemetry`:
+ * only tokens, timestamps, and I/O counters cross this interface.
+ */
+export declare function readRuntimeTuning(request: RuntimeTuningRequest, options?: RuntimeTelemetryOptions): RuntimeTuningTelemetry;
+//# sourceMappingURL=runtime-telemetry.d.ts.map

package/dist/core/hooks/adapter/runtime-telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-telemetry.d.ts","sourceRoot":"","sources":["../../../../src/core/hooks/adapter/runtime-telemetry.ts"],"names":[],"mappings":"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"}