@cesarus777/opencode-cgp 0.0.0-stage → 0.2.1

package/dist/types/tui/compactformat.d.ts

@@ -0,0 +1,28 @@
+import type { GuardRow } from "../family.js";
+export declare function tokens(value: number | undefined): string;
+export declare function columns(left: string, right: string, width: number): string[];
+export declare function progress(ratio: number | undefined, width: number): string;
+export interface MainSection {
+    readonly tone: "base" | "execution" | "pressure" | "measurement";
+    readonly lines: readonly string[];
+}
+export declare function mainSections(row: GuardRow | undefined, width: number, age: number): MainSection[];
+export declare function mainLines(row: GuardRow | undefined, width: number, age: number): string[];
+export declare const statusSymbol: {
+    readonly running: "●";
+    readonly idle: "◌";
+    readonly unknown: "◌";
+    readonly completed: "✓";
+    readonly failed: "✕";
+};
+export declare function agentHeading(row: GuardRow, width: number): string;
+export declare function agentLines(row: GuardRow, width: number): string[];
+export declare function subagentTree(rows: readonly GuardRow[], sessionID: string, collapsed: ReadonlySet<string>, hideCompleted: boolean, byPressure: boolean): {
+    all: GuardRow[];
+    visible: {
+        row: GuardRow;
+        depth: number;
+        hasChildren: boolean;
+    }[];
+};
+export declare function statistics(rows: readonly GuardRow[], sessionID: string, complete: boolean, width: number): string[];

package/dist/types/tui/format.d.ts

@@ -0,0 +1,8 @@
+import type { GuardRow } from "../family.js";
+export declare function quantity(n: number | undefined): string;
+export declare function cells(value: string): number;
+export declare function clip(value: string, width: number): string;
+export declare function rowLines(row: GuardRow, width: number): string[];
+export declare function detailLines(row: GuardRow | undefined, width: number, expanded?: boolean, ageMs?: number): string[];
+export declare function wrap(value: string, width: number): string[];
+export declare function performanceLines(row: GuardRow, width: number): string[];

package/dist/types/tui/inventory.d.ts

@@ -0,0 +1,18 @@
+import type { OpenCodeClient, SessionInfo } from "@opencode/client";
+interface Branch {
+    readonly id: string;
+    readonly depth: number;
+    readonly cursor?: string;
+    readonly cursors: readonly string[];
+}
+export interface Inventory {
+    readonly sessions: ReadonlyMap<string, SessionInfo>;
+    readonly complete: boolean;
+    readonly rootId: string;
+    readonly pages: number;
+    readonly pending: readonly Branch[];
+    readonly scanned: ReadonlySet<string>;
+    readonly damaged: boolean;
+}
+export declare function discoverFamily(client: Pick<OpenCodeClient, "session">, currentId: string, signal: AbortSignal, cached: (id: string) => SessionInfo | undefined, maxNodes?: number, previous?: Inventory): Promise<Inventory>;
+export {};

package/dist/types/tui/panel.d.ts

@@ -0,0 +1,8 @@
+import type { Plugin } from "@opencode/plugin/tui";
+import type { PanelInput } from "@opencode/plugin/tui/context";
+import type { GuardState } from "./state.js";
+export declare function GuardPanel(props: {
+    input: PanelInput;
+    state: GuardState;
+    context: Plugin.Context;
+}): import("solid-js").JSX.Element;

package/dist/types/tui/sidebar.d.ts

@@ -0,0 +1,13 @@
+import type { Plugin } from "@opencode/plugin/tui";
+import type { GuardState } from "./state.js";
+import type { GuardRow } from "../family.js";
+export declare function GuardView(props: {
+    sessionID: string;
+    state: GuardState;
+    context: Plugin.Context;
+    width: number;
+    expanded?: boolean;
+    family?: readonly GuardRow[];
+    selectedId?: string;
+    inspectId?: string | undefined;
+}): import("solid-js").JSX.Element;

package/dist/types/tui/state.d.ts

@@ -0,0 +1,30 @@
+import type { Plugin } from "@opencode/plugin/tui";
+export declare function createGuardState(context: Plugin.Context): {
+    version: import("solid-js").Accessor<number>;
+    acquire: (id: string) => {
+        update(next: string): void;
+        release(): void;
+    };
+    history(id: string, from: number, to: number, signal: AbortSignal): Promise<import("../historycharts.js").HistoryChartResult>;
+    rows: (stableOrder?: readonly string[], allDescendants?: boolean) => import("../family.js").GuardRow[];
+    dispose: () => void;
+    age(id: string): number;
+    health(): import("../snapshot.js").MonitorHealth | undefined;
+    connection(): "unavailable" | "loading" | "live" | "reconnecting" | "incompatible";
+    complete(): boolean;
+    refresh(): void;
+    loadMore(): void;
+    expand(id: string): void;
+};
+export type GuardState = ReturnType<typeof createGuardState>;
+export declare function locationKey(location: {
+    directory: string;
+    workspaceID?: string;
+}): string;
+export declare function sameLocation(a: {
+    directory: string;
+    workspaceID?: string;
+}, b: {
+    directory: string;
+    workspaceID?: string;
+}): boolean;

package/dist/types/tui/transport.d.ts

@@ -0,0 +1,40 @@
+import type { ContextSnapshot, MonitorHealth } from "../snapshot.js";
+export interface SnapshotTransport {
+    read(location: string, ids: readonly string[], signal: AbortSignal): Promise<unknown>;
+    subscribe(location: string, signal: AbortSignal): AsyncIterable<unknown>;
+}
+export type Connection = "loading" | "live" | "reconnecting" | "unavailable" | "incompatible";
+export declare class SnapshotClient {
+    private readonly transport;
+    private readonly changed;
+    private readonly elapsed;
+    readonly rows: Map<string, ContextSnapshot>;
+    health: MonitorHealth | undefined;
+    connection: Connection;
+    private epoch;
+    private sequence;
+    private revisions;
+    private baselines;
+    private controller;
+    private generation;
+    private ids;
+    private location;
+    private refreshTimer;
+    private reading;
+    private buffered;
+    private overflow;
+    private retryTimer;
+    private failures;
+    private serverAt;
+    private receivedAt;
+    private refreshAgain;
+    private subscriptionActive;
+    constructor(transport: SnapshotTransport, changed: () => void, elapsed?: () => number);
+    now(): number;
+    setIds(ids: readonly string[]): void;
+    start(location: string, ids: readonly string[]): void;
+    private merge;
+    refresh(): Promise<void>;
+    private supervise;
+    stop(): void;
+}

package/dist/types/tui.d.ts

@@ -0,0 +1,3 @@
+import { Plugin } from "@opencode/plugin/tui";
+declare const _default: Plugin.Definition;
+export default _default;

package/dist/types/types.d.ts

@@ -0,0 +1,153 @@
+export type Threshold = {
+    type: "tokens" | "ratio" | "remaining";
+    value: number;
+};
+export interface Match {
+    role?: "main" | "subagent";
+    model?: string;
+    agent?: string;
+}
+export interface Policy {
+    match: Match;
+    threshold: Threshold;
+}
+export interface Config {
+    enabled: boolean;
+    mode: "observe" | "enforce";
+    defaults: {
+        threshold: Threshold;
+    };
+    policies: Policy[];
+    safety: {
+        cooldownMs: number;
+        minReclaimTokens: number;
+        maxConsecutiveFailures: number;
+        pendingTimeoutMs: number;
+        staleMs: number;
+        maxSessions: number;
+        sessionTtlMs: number;
+        outputReserveTokens?: number;
+    };
+    metrics: {
+        enabled: boolean;
+        sampleIntervalMs: number;
+        rollingWindowMs: number;
+    };
+    history: {
+        enabled: boolean;
+        retentionDays: number;
+        maxBytes: number;
+        path?: string;
+    };
+    telemetry: {
+        enabled: boolean;
+        jsonl: boolean;
+        path?: string;
+        maxBytes: number;
+    };
+}
+export interface ModelLimits {
+    context: number;
+    input?: number;
+    output: number;
+}
+export interface Identity {
+    sessionId: string;
+    parentId?: string;
+    agent?: string;
+    model?: string;
+}
+export interface Tokens {
+    input: number;
+    output: number;
+    reasoning: number;
+    cache: {
+        read: number;
+        write: number;
+    };
+}
+export interface Measurement {
+    tokens: number;
+    at: number;
+    model: string;
+    requestId?: string;
+    provenance: "provider-normalized" | "serialized-estimate";
+    confidence: "reported" | "approximate";
+    scope: "completed-request" | "prepared-request";
+}
+export interface ContextUsage {
+    current?: Measurement;
+    cumulative?: Tokens;
+    cumulativeScope: "session" | "unknown";
+    peak: number;
+    modelRequests: number;
+    toolCalls: number;
+    countersSince: number;
+}
+export interface ContextUsageProvider {
+    getUsage(sessionId: string): Promise<ContextUsage>;
+}
+export type CompactionPhase = "idle" | "requesting" | "accepted" | "running" | "awaiting-measurement" | "blocked" | "uncertain";
+export interface CompactionState {
+    phase: CompactionPhase;
+    count: number;
+    failures: number;
+    consecutiveFailures: number;
+    lastAttempt?: number;
+    lastCompleted?: number;
+    before?: number | undefined;
+    beforeModel?: string | undefined;
+    beforeConfidence?: Measurement["confidence"] | undefined;
+    requestId?: string;
+    blockedReason?: string;
+    armed: boolean;
+}
+export interface Decision {
+    crossed: boolean;
+    reason: string;
+    policy: string;
+    threshold?: number;
+    budget?: number;
+    percentage?: number;
+}
+export interface SessionState extends Identity {
+    usage: ContextUsage;
+    compaction: CompactionState;
+    limits?: ModelLimits;
+    decision?: Decision;
+    lastSeen: number;
+    lastExecutionEnd?: number;
+    sequence: number;
+    active: boolean;
+}
+export type BudgetAction = {
+    type: "continue";
+} | {
+    type: "warn" | "compact" | "checkpoint" | "rotate" | "stop";
+    reason: string;
+};
+export interface BudgetInput {
+    session: Readonly<SessionState>;
+    now: number;
+    elapsedMs: number;
+    depth?: number;
+    inheritedTokenBudget?: number;
+}
+export interface BudgetController {
+    evaluate(input: BudgetInput): BudgetAction;
+}
+export declare class NoopBudgetController implements BudgetController {
+    evaluate(_input: BudgetInput): BudgetAction;
+}
+export interface TelemetryEvent {
+    time: number;
+    type: string;
+    session?: SessionState;
+    detail?: string;
+}
+export interface TelemetrySink {
+    emit(event: TelemetryEvent): void;
+}
+export interface CompactionPort {
+    compact(sessionId: string, requestId: string): Promise<void>;
+}

package/package.json

@@ -1,6 +1,112 @@
 {
   "name": "@cesarus777/opencode-cgp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.1",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./core": {
+      "types": "./dist/types/core.d.ts",
+      "import": "./dist/core.js",
+      "default": "./dist/core.js"
+    },
+    "./rpc": {
+      "types": "./dist/types/rpc.d.ts",
+      "import": "./dist/rpc.js",
+      "default": "./dist/rpc.js"
+    },
+    "./tui": {
+      "types": "./dist/types/tui.d.ts",
+      "import": "./dist/tui.js",
+      "default": "./dist/tui.js"
+    },
+    "./server": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "test": "bun test",
+    "typecheck": "tsc --noEmit",
+    "inspect": "bun src/cli.ts",
+    "test:live": "bun scripts/live.ts",
+    "format": "prettier --write src tests scripts docs README.md examples package.json tsconfig.json server.ts tui.tsx rpc.ts tsconfig.build.json .github AGENTS.md",
+    "format:check": "prettier --check src tests scripts docs README.md examples package.json tsconfig.json server.ts tui.tsx rpc.ts tsconfig.build.json .github AGENTS.md",
+    "test:tui-live": "bun scripts/tui-live.ts",
+    "bench:tui": "bun scripts/tui-bench.ts",
+    "build": "bun scripts/build.ts",
+    "prepack": "bun run build",
+    "prepare": "bun run build",
+    "test:package": "bun scripts/package-smoke.ts",
+    "validate": "bun run format:check && bun run typecheck && bun test && bun run test:package",
+    "test:metrics-live": "bun scripts/metrics-live.ts",
+    "charts": "bun src/cli.ts charts",
+    "test:metrics-server-live": "bun scripts/metrics-server-live.ts"
+  },
+  "dependencies": {
+    "@opencode/plugin": "2.0.29",
+    "@opencode/client": "2.0.29"
+  },
+  "devDependencies": {
+    "@types/bun": "1.3.11",
+    "typescript": "5.9.3",
+    "prettier": "3.6.2",
+    "solid-js": "1.9.15",
+    "@opentui/core": "0.5.17",
+    "@opentui/solid": "0.5.17",
+    "@opencode/theme": "2.0.29"
+  },
+  "engines": {
+    "bun": ">=1.1.34"
+  },
+  "peerDependencies": {
+    "solid-js": ">=1.9.0",
+    "@opentui/core": ">=0.5.17",
+    "@opentui/solid": ">=0.5.17"
+  },
+  "peerDependenciesMeta": {
+    "solid-js": {
+      "optional": true
+    },
+    "@opentui/core": {
+      "optional": true
+    },
+    "@opentui/solid": {
+      "optional": true
+    }
+  },
+  "description": "Early native compaction policy and context monitoring for OpenCode V2 root and nested-agent sessions.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cesarus777/opencode-cgp.git"
+  },
+  "homepage": "https://github.com/cesarus777/opencode-cgp#readme",
+  "bugs": {
+    "url": "https://github.com/cesarus777/opencode-cgp/issues"
+  },
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "context",
+    "compaction",
+    "tokens"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/types/index.d.ts",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "bin": {
+    "context-guard": "./dist/cli.js"
+  }
+}