ctxpool 0.1.1 → 0.5.0

package/dist/types.d.ts

@@ -28,13 +28,33 @@ export type FileChange = {
     untracked: boolean;
     diff?: string;
 };
-export type WorkPhase = "planning" | "implementation" | "debugging" | "verification" | "blocked" | "handoff";
+export type WorkPhase = "planning" | "implementation" | "debugging" | "verification" | "review" | "blocked" | "handoff";
 export type VerificationStatus = "passed" | "failed" | "unknown";
 export type VerificationCommand = {
     command: string;
     status: VerificationStatus;
+    exitCode?: number;
     evidence?: string;
 };
+export type PlanStatus = "pending" | "in_progress" | "completed";
+export type PlanItem = {
+    text: string;
+    status: PlanStatus;
+};
+/** A shell command the agent ran, with its real exit status when the log records one. */
+export type CommandRun = {
+    command: string;
+    status: VerificationStatus;
+    exitCode?: number;
+    /** First meaningful error line from a failed run. */
+    errorLine?: string;
+    /** Position in the session event stream, used to order runs against edits. */
+    seq: number;
+};
+export type FileEdit = {
+    path: string;
+    seq: number;
+};
 export type VerificationSummary = {
     status: VerificationStatus;
     commands: VerificationCommand[];
@@ -82,10 +102,11 @@ export type TeamSyncPolicy = {
 export type EngineeringMemory = {
     version: 1;
     identity: StableIdentity;
-    positioning: {
-        category: "handoff-ledger";
-        buyer: "ai-heavy-engineering-teams";
-        moat: "provenance-backed-engineering-memory";
+    /** Present on packets captured before v0.2; no longer written. */
+    positioning?: {
+        category: string;
+        buyer: string;
+        moat: string;
     };
     intent: MemoryFact[];
     decisions: MemoryFact[];
@@ -97,12 +118,12 @@ export type EngineeringMemory = {
     teamSync: TeamSyncPolicy;
 };
 export type AgentSignal = {
-    source: "codex" | "claude" | "unknown";
+    source: SourceAgent | "unknown";
     path: string;
     modifiedAt: string;
     snippets: string[];
 };
-export type SourceAgent = "codex" | "claude";
+export type SourceAgent = "codex" | "claude" | "gemini" | "antigravity";
 export type TranscriptEntry = {
     role: "user" | "assistant" | "tool" | "system";
     text: string;
@@ -121,6 +142,15 @@ export type SourceSession = {
     transcriptExcerpt: string;
     threadName?: string;
     supplementalPaths?: string[];
+    /** Latest structured plan the agent maintained (TodoWrite, update_plan, task tools). */
+    plan?: PlanItem[];
+    /** Latest plan the agent proposed in prose (ExitPlanMode, plan mode). */
+    planText?: string;
+    commands?: CommandRun[];
+    edits?: FileEdit[];
+    /** Summary the agent wrote when it compacted earlier context. */
+    compactSummary?: string;
+    links?: string[];
 };
 export type HandoffSections = {
     goal: string;
@@ -155,6 +185,9 @@ export type HandoffContinuitySummary = {
     commandsRun: string[];
     errors: string[];
     decisions: string[];
+    plan?: PlanItem[];
+    constraints?: string[];
+    title?: string;
     sourceSession?: {
         source: SourceAgent;
         id: string;
@@ -183,6 +216,8 @@ export type HandoffPacket = {
     engineeringMemory?: EngineeringMemory;
     markdown: string;
     markdownPath: string;
+    /** Estimated tokens in `markdown`. */
+    tokenEstimate?: number;
 };
 export type HandoffSummary = {
     id: string;
@@ -197,6 +232,54 @@ export type HandoffSummary = {
     filesTouched: string[];
     status: string[];
 };
+/** Compact view of a handoff for the web UI's lists and charts. */
+export type HandoffListItem = {
+    id: string;
+    task: string;
+    createdAt: string;
+    title?: string;
+    source?: SourceAgent;
+    sessionId?: string;
+    targetAgent?: string;
+    repoPath: string;
+    repoName: string;
+    branch: string;
+    commit: string;
+    isGitRepo: boolean;
+    phase: WorkPhase;
+    objective: string;
+    nextAction: string;
+    verification: VerificationStatus;
+    checks: {
+        passed: number;
+        failed: number;
+        unknown: number;
+    };
+    plan: {
+        total: number;
+        completed: number;
+        inProgress: number;
+    };
+    files: {
+        count: number;
+        additions: number;
+        deletions: number;
+        paths: string[];
+    };
+    blockers: number;
+    tokens: number;
+    transcriptItems: number;
+};
+export type UiStatus = {
+    version: string;
+    home: string;
+    handoffCount: number;
+    taskCount: number;
+    packCount: number;
+    /** Newest handoff time; the UI polls this to pick up new captures. */
+    latestAt?: string;
+    agents: Record<SourceAgent, boolean>;
+};
 export type ContextBlockCategory = "intent" | "instruction" | "decision" | "constraint" | "verification" | "risk" | "next-action" | "changed-file" | "transcript";
 export type ContextBlock = {
     id: string;
@@ -234,9 +317,11 @@ export type ContextPackOutput = {
         updatedAt: string;
         includeRawTranscript: boolean;
         estimatedChars: number;
+        estimatedTokens: number;
         warnings: string[];
         items: ContextPackItem[];
     };
     estimatedChars: number;
+    estimatedTokens: number;
     warnings: string[];
 };

package/dist/ui.d.ts

@@ -2,6 +2,14 @@ import { type IncomingMessage } from "node:http";
 export type UiOptions = {
     host?: string;
     port?: number;
+    /** Try the next ports when the requested one is busy. */
+    fallback?: boolean;
+};
+export type RunningUi = {
+    url: string;
+    host: string;
+    port: number;
+    close: () => Promise<void>;
 };
 export type FileViewResult = {
     ok: true;
@@ -19,9 +27,10 @@ export type FileViewResult = {
     error: string;
 };
 export declare function isValidContextPackBody(body: Record<string, unknown>): boolean;
-export declare function startUi(options?: UiOptions): Promise<void>;
+export declare function startUi(options?: UiOptions): Promise<RunningUi>;
 export declare function isLocalRequest(req: Pick<IncomingMessage, "headers">): boolean;
 export declare function readRepoFileForView(repoPath: string, filePath: string): FileViewResult;
+/** Resolve `filePath` inside `repoPath`, following symlinks so a link cannot point outside the repository. */
 export declare function resolveSafeRepoPath(repoPath: string, filePath: string): {
     ok: true;
     path: string;