@poncho-ai/harness 0.53.0 → 0.57.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @poncho-ai/harness@0.53.0 build /home/runner/work/poncho-ai/poncho-ai/packages/harness
+> @poncho-ai/harness@0.57.0 build /home/runner/work/poncho-ai/poncho-ai/packages/harness
 > node scripts/embed-docs.js && tsup src/index.ts --format esm --dts
 
 [embed-docs] Generated poncho-docs.ts with 4 topics
@@ -8,9 +8,9 @@
 CLI tsup v8.5.1
 CLI Target: es2022
 ESM Build start
+ESM dist/index.js            565.81 KB
 ESM dist/isolate-F2PPSUL6.js 53.82 KB
-ESM dist/index.js            541.42 KB
-ESM ⚡️ Build success in 239ms
+ESM ⚡️ Build success in 254ms
 DTS Build start
-DTS ⚡️ Build success in 7708ms
-DTS dist/index.d.ts 94.04 KB
+DTS ⚡️ Build success in 7133ms
+DTS dist/index.d.ts 104.68 KB

package/CHANGELOG.md

@@ -1,5 +1,84 @@
 # @poncho-ai/harness
 
+## 0.57.0
+
+### Minor Changes
+
+- [#153](https://github.com/cesr/poncho-ai/pull/153) [`d39d8fe`](https://github.com/cesr/poncho-ai/commit/d39d8fe0b178c102c728dbb4c000786f0a50a83b) Thanks [@cesr](https://github.com/cesr)! - Dual-write conversation entries + opt-in parity checker (Phase 3b).
+
+  At each conversation write site the orchestrator now ALSO appends the matching
+  append-only `ConversationEntry`s (`user_message`, `assistant_message`,
+  `assistant_amendment`, `harness_message`, `compaction`, `subagent_result`,
+  `callback_started`) alongside the existing mutable-blob write. This is purely
+  additive instrumentation: read paths still use the blob, so the dual-write is
+  fire-and-forget and can never corrupt behavior.
+
+  An opt-in parity checker (gated on `PONCHO_VERIFY_ENTRIES=1`) rebuilds the LLM
+  context and display snapshot from the entry log after each turn finalizes and
+  logs any divergence from the blob under a `[entries-parity]` prefix. It never
+  throws.
+
+  Re-exports the entry types and rebuild functions (`buildLlmContext`,
+  `buildDisplaySnapshot`, `getPendingSubagentResults`) from the package root so
+  downstream consumers can build on the substrate.
+
+## 0.56.0
+
+### Minor Changes
+
+- [#151](https://github.com/cesr/poncho-ai/pull/151) [`4c116d8`](https://github.com/cesr/poncho-ai/commit/4c116d8f883c1d486b86b6c254334602326d7713) Thanks [@cesr](https://github.com/cesr)! - Add append-only conversation entry persistence (Phase 3 substrate).
+
+  Introduces `appendEntries` / `readEntries` on the `ConversationStore` and
+  `StorageEngine.conversations` interfaces, implemented for SQLite, PostgreSQL
+  (via `SqlStorageEngine`), and the in-memory stores. A new `conversation_entries`
+  table (migration v8) stores each entry with an app-assigned per-conversation
+  monotonic `seq`, a unique `id`, a JSON `payload`, and a `UNIQUE
+(conversation_id, seq)` constraint.
+
+  Purely additive: no existing table, behavior, or read path changes — this is
+  the foundation for a later dual-write phase.
+
+## 0.55.0
+
+### Minor Changes
+
+- [#149](https://github.com/cesr/poncho-ai/pull/149) [`f5a8260`](https://github.com/cesr/poncho-ai/commit/f5a8260d0515038afc1797d00507908c334115ff) Thanks [@cesr](https://github.com/cesr)! - compaction: preserve subagent context and prior summaries, harden the split
+
+  Three improvements to context compaction (fires at ~75% context):
+  - **Split safety**: `findSafeSplitPoint` now refuses a split whose compacted
+    side would end on an assistant message with unanswered `tool_calls` (its
+    answering `role:"tool"` result having moved to the preserved side), walking
+    earlier to the next clean `user` boundary. Prevents orphaning a tool-call
+    relationship inside the summary boundary. Still returns `-1` when no safe
+    point exists.
+  - **Subagent ledger**: while compacting, scans for subagent-callback records
+    (metadata `_subagentCallback`/`subagentCallback`, or text starting with
+    `[Subagent Result]`) and any `## Subagents` block embedded in a prior
+    compaction summary, then renders a combined, deduped (by `subagentId`)
+    ledger that is appended VERBATIM after the LLM summary text — so the model
+    can never paraphrase or truncate subagent results away. Cumulative across
+    successive compactions.
+  - **Cumulative summary**: when the first compacted message is itself a prior
+    compaction summary, it is passed to the summarizer in full (not truncated
+    to 1200 chars) and the prompt instructs the model to merge-and-update the
+    prior working state rather than re-summarize it from scratch. All other
+    messages keep the 1200-char truncation.
+
+## 0.54.0
+
+### Minor Changes
+
+- [#147](https://github.com/cesr/poncho-ai/pull/147) [`a3eed14`](https://github.com/cesr/poncho-ai/commit/a3eed142832318b6397cd73819d3296c79d6eff0) Thanks [@cesr](https://github.com/cesr)! - storage: add append-only conversation-entry substrate (unused groundwork)
+
+  Pure entry types + rebuild functions (`buildLlmContext`,
+  `buildDisplaySnapshot`, `getPendingSubagentResults`) for the eventual
+  append-only conversation model that removes the mutable-blob clobber race
+  (the root cause behind lost subagent results). No storage-engine wiring
+  and no live callers yet — additive, deploys nothing behavioral. The
+  rebuild logic (compaction overlay, amendment folding, callback-consumption)
+  is covered by unit tests so the design is proven before the bigger
+  dual-write / migration / cutover PRs.
+
 ## 0.53.0
 
 ### Minor Changes

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { LanguageModel } from 'ai';
 import * as _poncho_ai_sdk from '@poncho-ai/sdk';
-import { Message, ToolContext, ToolDefinition, JsonSchema, RunResult, AgentFailure, RunInput, AgentEvent, FileInput } from '@poncho-ai/sdk';
+import { Message, ToolContext, ToolDefinition, JsonSchema, RunResult, AgentFailure, RunInput, AgentEvent, FileInput, Logger } from '@poncho-ai/sdk';
 export { ToolDefinition, defineTool } from '@poncho-ai/sdk';
 import { FsStat, IFileSystem, BufferEncoding, FileContent, MkdirOptions, RmOptions, CpOptions, Bash } from 'just-bash';
 import { z } from 'zod';
@@ -96,6 +96,12 @@ declare const estimateTotalTokens: (systemPrompt: string, messages: Message[], t
  * and everything from it onward is preserved. The split always lands just
  * before a `user` message to avoid breaking assistant+tool pairs.
  *
+ * Defensive guard: even at a `user` boundary, refuse a split whose compacted
+ * side would END on an assistant message with unanswered tool_calls (its
+ * `tool` result having moved to the preserved side). Such a split would
+ * orphan the tool_calls inside the summary boundary. When that happens we
+ * walk earlier to the next safe `user` boundary.
+ *
  * Returns -1 if no valid split point is found.
  */
 declare const findSafeSplitPoint: (messages: Message[], keepRecentMessages: number) => number;
@@ -120,6 +126,127 @@ interface CompactResult {
  */
 declare const compactMessages: (model: LanguageModel, messages: Message[], config: CompactionConfig, options?: CompactMessagesOptions) => Promise<CompactResult>;
 
+/**
+ * Append-only conversation entries (Phase 3 substrate).
+ *
+ * The eventual replacement for the mutable per-conversation JSON blob: a
+ * conversation becomes an ordered, append-only list of entries, and the
+ * mutable-blob clobber race (two writers serializing a stale whole-blob
+ * snapshot over each other — the root cause behind lost subagent results)
+ * stops being expressible.
+ *
+ * This module is intentionally PURE: it defines the entry shapes and the
+ * functions that rebuild a conversation's LLM context / display transcript
+ * / pending-subagent-results from an entry list. No storage engine, no DB,
+ * no wiring into the live run loop yet — so it deploys nothing and is
+ * fully unit-testable. The engine implementations (append/read on
+ * postgres/sqlite/memory) and the write-site conversions come in later PRs
+ * once this rebuild logic is proven.
+ *
+ * Ordering: every entry carries a monotonic per-conversation `seq`. Entries
+ * are assumed sorted by `seq` ascending when passed to the rebuild fns.
+ */
+interface BaseEntry {
+    /** Stable cross-reference id (uuid). */
+    id: string;
+    /** Monotonic per-conversation order. */
+    seq: number;
+    createdAt: number;
+}
+/** A user-role display message (incl. typed subagent-callback messages). */
+interface UserMessageEntry extends BaseEntry {
+    type: "user_message";
+    message: Message;
+    turnId: string;
+    /** Hidden from the display transcript (e.g. a framed job prompt, an
+     *  onboarding seed, or an injected subagent-result message). Still part
+     *  of the record; just not rendered as a chat bubble. */
+    hidden?: boolean;
+}
+/** The final assistant bubble for a completed/cancelled/errored turn. */
+interface AssistantMessageEntry extends BaseEntry {
+    type: "assistant_message";
+    message: Message;
+    turnId: string;
+    runId: string;
+}
+/** A post-hoc edit to an already-emitted assistant message — replaces the
+ *  orchestrator/resume "mutate the last assistant message in place" writes
+ *  with an append. Applied at rebuild time. */
+interface AssistantAmendmentEntry extends BaseEntry {
+    type: "assistant_amendment";
+    targetEntryId: string;
+    appendText?: string;
+}
+/** One LLM-transcript message (the model-visible form). Appended from the
+ *  run loop per step — never diffed from an array. */
+interface HarnessMessageEntry extends BaseEntry {
+    type: "harness_message";
+    message: Message;
+    turnId: string;
+}
+/** Compaction overlay: nothing is deleted. At rebuild, the LLM context is
+ *  the latest compaction's `summaryMessage` followed by the harness
+ *  messages from `firstKeptSeq` onward. */
+interface CompactionEntry extends BaseEntry {
+    type: "compaction";
+    summaryMessage: Message;
+    firstKeptSeq: number;
+    tokensBefore?: number;
+    tokensAfter?: number;
+}
+/** A finished subagent's result arriving for the parent. Pending = a
+ *  subagent_result whose seq is not listed in any later callback_started. */
+interface SubagentResultEntry extends BaseEntry {
+    type: "subagent_result";
+    result: PendingSubagentResult;
+}
+/** Marks which subagent_result entries a callback turn consumed (by seq).
+ *  Consumption is an append, never a delete. */
+interface CallbackStartedEntry extends BaseEntry {
+    type: "callback_started";
+    consumedSeqs: number[];
+}
+type ConversationEntry = UserMessageEntry | AssistantMessageEntry | AssistantAmendmentEntry | HarnessMessageEntry | CompactionEntry | SubagentResultEntry | CallbackStartedEntry;
+/**
+ * An entry to append, before the engine assigns `seq` and `createdAt`. This
+ * is a DISTRIBUTIVE omit — `Omit<ConversationEntry, K>` over a union would
+ * collapse to only the keys common to every member (dropping `message`,
+ * `summaryMessage`, etc.), so we distribute over the union with a
+ * conditional type to omit those fields from each member individually.
+ */
+type NewConversationEntry = ConversationEntry extends infer T ? T extends ConversationEntry ? Omit<T, "seq" | "createdAt"> : never : never;
+/**
+ * Rebuild the LLM-visible message context from the entry log.
+ *
+ * If a compaction overlay exists, the context is its summary message
+ * followed by every harness message with seq >= firstKeptSeq (a later
+ * compaction's firstKeptSeq can point at an earlier summary that was
+ * itself appended as a harness message, so layered compactions just work).
+ * With no compaction, it's every harness message in order.
+ */
+declare function buildLlmContext(entries: ConversationEntry[]): Message[];
+interface DisplaySnapshot {
+    messages: Message[];
+    /** Total display messages available (for pagination UIs). */
+    totalMessages: number;
+    /** seq of the first message returned (a `beforeSeq` pagination cursor). */
+    headSeq: number | null;
+}
+/**
+ * Rebuild the display transcript (the user-visible chat) from the entry
+ * log, returning the trailing `tailN` messages. Amendments are folded into
+ * their target assistant message; hidden user messages are dropped.
+ */
+declare function buildDisplaySnapshot(entries: ConversationEntry[], tailN: number): DisplaySnapshot;
+/**
+ * Subagent results that have arrived but not yet been consumed by a
+ * callback turn — the append-only replacement for the mutable
+ * `pendingSubagentResults` array. A result is pending unless a later
+ * callback_started lists its seq in `consumedSeqs`.
+ */
+declare function getPendingSubagentResults(entries: ConversationEntry[]): PendingSubagentResult[];
+
 interface ConversationState {
     runId: string;
     messages: Message[];
@@ -255,6 +382,19 @@ interface ConversationStore {
     clearCallbackLock(conversationId: string): Promise<Conversation | undefined>;
     /** List thread conversations anchored under `parentConversationId`. */
     listThreads(parentConversationId: string): Promise<ConversationSummary[]>;
+    /**
+     * Append entries to a conversation's append-only log (Phase 3 substrate).
+     * Assigns a per-conversation monotonic `seq` and a `createdAt` to each
+     * entry, persists them in order, and returns the stored entries with those
+     * fields filled in. Additive — no existing read path consumes these yet.
+     */
+    appendEntries(conversationId: string, agentId: string, tenantId: string | null, entries: NewConversationEntry[]): Promise<ConversationEntry[]>;
+    /** Read a conversation's entries ordered by `seq` ascending. */
+    readEntries(conversationId: string, opts?: {
+        types?: string[];
+        afterSeq?: number;
+        limit?: number;
+    }): Promise<ConversationEntry[]>;
 }
 type StateProviderName = "local" | "memory" | "sqlite" | "postgresql" | "redis" | "upstash" | "dynamodb";
 interface StateConfig {
@@ -276,6 +416,7 @@ declare class InMemoryStateStore implements StateStore {
 }
 declare class InMemoryConversationStore implements ConversationStore {
     private readonly conversations;
+    private readonly entries;
     private readonly ttlMs?;
     constructor(ttlSeconds?: number);
     private isExpired;
@@ -292,6 +433,12 @@ declare class InMemoryConversationStore implements ConversationStore {
     appendSubagentResult(conversationId: string, result: PendingSubagentResult): Promise<void>;
     clearCallbackLock(conversationId: string): Promise<Conversation | undefined>;
     listThreads(parentConversationId: string): Promise<ConversationSummary[]>;
+    appendEntries(conversationId: string, _agentId: string, _tenantId: string | null, entries: NewConversationEntry[]): Promise<ConversationEntry[]>;
+    readEntries(conversationId: string, opts?: {
+        types?: string[];
+        afterSeq?: number;
+        limit?: number;
+    }): Promise<ConversationEntry[]>;
 }
 type ConversationSummary = {
     conversationId: string;
@@ -945,6 +1092,19 @@ interface StorageEngine {
         clearCallbackLock(conversationId: string): Promise<Conversation | undefined>;
         /** List thread conversations anchored under `parentConversationId`. */
         listThreads(parentConversationId: string): Promise<ConversationSummary[]>;
+        /**
+         * Append entries to a conversation's append-only log (Phase 3 substrate).
+         * Assigns a per-conversation monotonic `seq` and `createdAt` to each entry,
+         * persists them in order, and returns the stored entries. Additive — no
+         * read path consumes these yet.
+         */
+        appendEntries(conversationId: string, agentId: string, tenantId: string | null, entries: NewConversationEntry[]): Promise<ConversationEntry[]>;
+        /** Read a conversation's entries ordered by `seq` ascending. */
+        readEntries(conversationId: string, opts?: {
+            types?: string[];
+            afterSeq?: number;
+            limit?: number;
+        }): Promise<ConversationEntry[]>;
     };
     memory: {
         get(tenantId?: string | null): Promise<MainMemory>;
@@ -1590,6 +1750,7 @@ declare class TelemetryEmitter {
 declare class InMemoryEngine implements StorageEngine {
     readonly agentId: string;
     private convs;
+    private entries;
     private mem;
     private todoData;
     private reminderData;
@@ -1610,6 +1771,12 @@ declare class InMemoryEngine implements StorageEngine {
         appendSubagentResult: (conversationId: string, result: PendingSubagentResult) => Promise<void>;
         clearCallbackLock: (conversationId: string) => Promise<Conversation | undefined>;
         listThreads: (parentConversationId: string) => Promise<ConversationSummary[]>;
+        appendEntries: (conversationId: string, _agentId: string, _tenantId: string | null, entries: NewConversationEntry[]) => Promise<ConversationEntry[]>;
+        readEntries: (conversationId: string, opts?: {
+            types?: string[];
+            afterSeq?: number;
+            limit?: number;
+        }) => Promise<ConversationEntry[]>;
     };
     memory: {
         get: (tenantId?: string | null) => Promise<MainMemory>;
@@ -1727,6 +1894,12 @@ declare abstract class SqlStorageEngine implements StorageEngine {
         appendSubagentResult: (conversationId: string, result: PendingSubagentResult) => Promise<void>;
         clearCallbackLock: (conversationId: string) => Promise<Conversation | undefined>;
         listThreads: (parentConversationId: string) => Promise<ConversationSummary[]>;
+        appendEntries: (conversationId: string, agentId: string, tenantId: string | null, entries: NewConversationEntry[]) => Promise<ConversationEntry[]>;
+        readEntries: (conversationId: string, opts?: {
+            types?: string[];
+            afterSeq?: number;
+            limit?: number;
+        }) => Promise<ConversationEntry[]>;
     };
     memory: {
         get: (tenantId?: string | null) => Promise<MainMemory>;
@@ -2230,4 +2403,45 @@ interface RunConversationTurnResult {
 }
 declare const runConversationTurn: (opts: RunConversationTurnOpts) => Promise<RunConversationTurnResult>;
 
-export { type ActiveConversationRun, type ActiveSubagentRun, type AgentFrontmatter, AgentHarness, type AgentIdentity, type AgentLimitsConfig, type AgentModelConfig, AgentOrchestrator, type ApprovalEventItem, type ArchivedToolResult$1 as ArchivedToolResult, type BashConfig, BashEnvironmentManager, type BashExecutionLimits, type BuiltInToolToggles, CALLBACK_LOCK_STALE_MS, type CompactMessagesOptions, type CompactResult, type CompactionConfig, type ContinuationHooks, type Conversation, type ConversationCreateInit, type ConversationState, type ConversationStatusSnapshot, type ConversationStore, type ConversationSummary, type CreateSkillToolsOptions, type CronJobConfig, DEFAULT_AGENT_DESCRIPTION, DEFAULT_AGENT_NAME, DEFAULT_MAX_STEPS, DEFAULT_MODEL_NAME, DEFAULT_MODEL_PROVIDER, DEFAULT_TEMPERATURE, DEFAULT_TIMEOUT, type DefaultAgentDefinitionOptions, type EventSink, type ExecuteTurnResult, type HarnessOptions, type HarnessRunOutput, type HistorySource, InMemoryConversationStore, InMemoryEngine, InMemoryStateStore, type IsolateBinding, type IsolateConfig, LocalMcpBridge, LocalUploadStore, MAX_CONCURRENT_SUBAGENTS, MAX_CONTINUATION_COUNT, MAX_SUBAGENT_CALLBACK_COUNT, MAX_SUBAGENT_NESTING, type MainMemory, type McpConfig, type MemoryConfig, type MemoryStore, type MessagingChannelConfig, type ModelProviderFactory, type MountProvider, type NetworkConfig, OPENAI_CODEX_CLIENT_ID, type OpenAICodexAuthConfig, type OpenAICodexDeviceAuthRequest, type OpenAICodexSession, type OrchestratorHooks, type OrchestratorOptions, type OtlpConfig, type OtlpOption, PONCHO_UPLOAD_SCHEME, type ParsedAgent, type PendingSubagentApproval, type PendingSubagentResult, type PendingToolCall, type PonchoConfig, PonchoFsAdapter, PostgresEngine, type ProviderConfig, type Recurrence, type RecurrenceType, type Reminder, type ReminderCreateInput, type ReminderStatus, type ReminderStore, type RemoteMcpServerConfig, type RunConversationTurnOpts, type RunConversationTurnResult, type RunOutcome, type RunRequest, type RuntimeRenderContext, S3UploadStore, STALE_SUBAGENT_THRESHOLD_MS, STORAGE_SCHEMA_VERSION, type SecretsStore, type SkillContextEntry, type SkillMetadata, type SkillSource, SqliteEngine, type StateConfig, type StateProviderName, type StateStore, type StorageConfig, type StorageEngine, type StorageFactoryOptions, type StorageProvider, type StoredApproval, type SubagentManager, type SubagentResult, type SubagentSpawnResult, type SubagentSummary, type SubagentTranscript, type SubagentTranscriptMode, TOOL_RESULT_ARCHIVE_PARAM, type TelemetryConfig, TelemetryEmitter, type TenantTokenPayload, type ToolAccess, type ToolCall, ToolDispatcher, type ToolExecutionResult, type TurnDraftState, type TurnResultMetadata, type TurnSection, type UploadStore, type UploadsConfig, VFS_SCHEME, VercelBlobUploadStore, type VfsDirEntry, type VfsStat, type VirtualMount, abnormalEndResponse, applyTurnMetadata, buildAgentDirectoryName, buildApprovalCheckpoints, buildAssistantMetadata, buildSkillContextWindow, buildToolCompletedText, cloneSections, compactMessages, completeOpenAICodexDeviceAuth, computeNextOccurrence, createBashTool, createConversationStore, createConversationStoreFromEngine, createDefaultTools, createDeleteDirectoryTool, createDeleteTool, createEditTool, createMemoryStore, createMemoryStoreFromEngine, createMemoryTools, createModelProvider, createReminderStore, createReminderStoreFromEngine, createReminderTools, createSearchTools, createSecretsStore, createSkillTools, createStateStore, createStorageEngine, createSubagentTools, createTodoStoreFromEngine, createTurnDraftState, createUploadStore, createWriteTool, decodeFileInputData, defaultAgentDefinition, deleteOpenAICodexSession, deriveUploadKey, ensureAgentIdentity, estimateTokens, estimateTotalTokens, executeConversationTurn, findSafeSplitPoint, flushTurnDraft, generateAgentId, getAgentStoreDirectory, getModelContextWindow, getOpenAICodexAccessToken, getOpenAICodexAuthFilePath, getOpenAICodexRequiredScopes, getPonchoStoreRoot, isMessageArray, jsonSchemaToZod, lastAssistantText, loadCanonicalHistory, loadPonchoConfig, loadRunHistory, loadSkillContext, loadSkillInstructions, loadSkillMetadata, loadSkillMetadataFromDirs, loadVfsSkillMetadata, mergeSkills, normalizeApprovalCheckpoint, normalizeOtlp, normalizeScriptPolicyPath, normalizeToolAccess, parseAgentFile, parseAgentMarkdown, parseSkillFrontmatter, ponchoDocsTool, readOpenAICodexSession, readSkillResource, realResponseText, recordStandardTurnEvent, renderAgentPrompt, resolveAgentIdentity, resolveCompactionConfig, resolveEnv, resolveMemoryConfig, resolveRunRequest, resolveSkillDirs, resolveStateConfig, runConversationTurn, slugifyStorageComponent, startOpenAICodexDeviceAuth, verifyTenantToken, withToolResultArchiveParam, writeOpenAICodexSession };
+/** True when dual-write parity verification is opted in via env. */
+declare const entriesParityEnabled: () => boolean;
+type NewEntryNoId = NewConversationEntry extends infer T ? T extends NewConversationEntry ? Omit<T, "id"> : never : never;
+/**
+ * Append entries to the conversation's append-only log, mirroring an existing
+ * blob write. Best-effort and non-blocking by contract:
+ *   - stamps a fresh uuid `id` on each entry (required input column),
+ *   - never throws (logs and returns [] on failure),
+ *   - is safe to `void` (callers needn't await).
+ *
+ * Returns the stored entries (with seq/createdAt) for callers that want them
+ * (e.g. to learn the assistant entry's id for a later amendment), or [] on
+ * empty input / failure.
+ */
+declare const appendEntriesSafe: (store: ConversationStore, conversation: Pick<Conversation, "conversationId" | "ownerId" | "tenantId">, entries: NewEntryNoId[], log: Logger) => Promise<ConversationEntry[]>;
+/**
+ * The harness messages added during the just-finished turn — i.e. the suffix
+ * of the new `_harnessMessages` array beyond what was there before the turn.
+ *
+ * BEST-EFFORT: the blob replaces `_harnessMessages` wholesale (it's not an
+ * append log), so we recover "what's new" by length-diffing prev vs next.
+ * When a compaction collapsed history this turn, `next` can be SHORTER than
+ * `prev`; in that case there's no clean suffix and we return the whole `next`
+ * so the entry log still ends up with the model-visible context (parity will
+ * flag the over-count for review). The compaction entry (appended separately)
+ * is what makes rebuild correct in that case.
+ */
+declare const newHarnessMessagesThisTurn: (prev: Message[] | undefined, next: Message[] | undefined) => {
+    messages: Message[];
+    approximate: boolean;
+};
+/**
+ * Rebuild LLM context + display snapshot from the entry log and diff against
+ * the blob. Logs under `[entries-parity]` with the conversationId. Never
+ * throws. No-op unless PONCHO_VERIFY_ENTRIES === "1".
+ */
+declare const verifyEntriesParity: (store: ConversationStore, conversationId: string, blob: {
+    harnessMessages?: Message[];
+    displayMessages?: Message[];
+}, log: Logger) => Promise<void>;
+
+export { type ActiveConversationRun, type ActiveSubagentRun, type AgentFrontmatter, AgentHarness, type AgentIdentity, type AgentLimitsConfig, type AgentModelConfig, AgentOrchestrator, type ApprovalEventItem, type ArchivedToolResult$1 as ArchivedToolResult, type AssistantAmendmentEntry, type AssistantMessageEntry, type BashConfig, BashEnvironmentManager, type BashExecutionLimits, type BuiltInToolToggles, CALLBACK_LOCK_STALE_MS, type CallbackStartedEntry, type CompactMessagesOptions, type CompactResult, type CompactionConfig, type CompactionEntry, type ContinuationHooks, type Conversation, type ConversationCreateInit, type ConversationEntry, type ConversationState, type ConversationStatusSnapshot, type ConversationStore, type ConversationSummary, type CreateSkillToolsOptions, type CronJobConfig, DEFAULT_AGENT_DESCRIPTION, DEFAULT_AGENT_NAME, DEFAULT_MAX_STEPS, DEFAULT_MODEL_NAME, DEFAULT_MODEL_PROVIDER, DEFAULT_TEMPERATURE, DEFAULT_TIMEOUT, type DefaultAgentDefinitionOptions, type DisplaySnapshot, type EventSink, type ExecuteTurnResult, type HarnessMessageEntry, type HarnessOptions, type HarnessRunOutput, type HistorySource, InMemoryConversationStore, InMemoryEngine, InMemoryStateStore, type IsolateBinding, type IsolateConfig, LocalMcpBridge, LocalUploadStore, MAX_CONCURRENT_SUBAGENTS, MAX_CONTINUATION_COUNT, MAX_SUBAGENT_CALLBACK_COUNT, MAX_SUBAGENT_NESTING, type MainMemory, type McpConfig, type MemoryConfig, type MemoryStore, type MessagingChannelConfig, type ModelProviderFactory, type MountProvider, type NetworkConfig, type NewConversationEntry, OPENAI_CODEX_CLIENT_ID, type OpenAICodexAuthConfig, type OpenAICodexDeviceAuthRequest, type OpenAICodexSession, type OrchestratorHooks, type OrchestratorOptions, type OtlpConfig, type OtlpOption, PONCHO_UPLOAD_SCHEME, type ParsedAgent, type PendingSubagentApproval, type PendingSubagentResult, type PendingToolCall, type PonchoConfig, PonchoFsAdapter, PostgresEngine, type ProviderConfig, type Recurrence, type RecurrenceType, type Reminder, type ReminderCreateInput, type ReminderStatus, type ReminderStore, type RemoteMcpServerConfig, type RunConversationTurnOpts, type RunConversationTurnResult, type RunOutcome, type RunRequest, type RuntimeRenderContext, S3UploadStore, STALE_SUBAGENT_THRESHOLD_MS, STORAGE_SCHEMA_VERSION, type SecretsStore, type SkillContextEntry, type SkillMetadata, type SkillSource, SqliteEngine, type StateConfig, type StateProviderName, type StateStore, type StorageConfig, type StorageEngine, type StorageFactoryOptions, type StorageProvider, type StoredApproval, type SubagentManager, type SubagentResult, type SubagentResultEntry, type SubagentSpawnResult, type SubagentSummary, type SubagentTranscript, type SubagentTranscriptMode, TOOL_RESULT_ARCHIVE_PARAM, type TelemetryConfig, TelemetryEmitter, type TenantTokenPayload, type ToolAccess, type ToolCall, ToolDispatcher, type ToolExecutionResult, type TurnDraftState, type TurnResultMetadata, type TurnSection, type UploadStore, type UploadsConfig, type UserMessageEntry, VFS_SCHEME, VercelBlobUploadStore, type VfsDirEntry, type VfsStat, type VirtualMount, abnormalEndResponse, appendEntriesSafe, applyTurnMetadata, buildAgentDirectoryName, buildApprovalCheckpoints, buildAssistantMetadata, buildDisplaySnapshot, buildLlmContext, buildSkillContextWindow, buildToolCompletedText, cloneSections, compactMessages, completeOpenAICodexDeviceAuth, computeNextOccurrence, createBashTool, createConversationStore, createConversationStoreFromEngine, createDefaultTools, createDeleteDirectoryTool, createDeleteTool, createEditTool, createMemoryStore, createMemoryStoreFromEngine, createMemoryTools, createModelProvider, createReminderStore, createReminderStoreFromEngine, createReminderTools, createSearchTools, createSecretsStore, createSkillTools, createStateStore, createStorageEngine, createSubagentTools, createTodoStoreFromEngine, createTurnDraftState, createUploadStore, createWriteTool, decodeFileInputData, defaultAgentDefinition, deleteOpenAICodexSession, deriveUploadKey, ensureAgentIdentity, entriesParityEnabled, estimateTokens, estimateTotalTokens, executeConversationTurn, findSafeSplitPoint, flushTurnDraft, generateAgentId, getAgentStoreDirectory, getModelContextWindow, getOpenAICodexAccessToken, getOpenAICodexAuthFilePath, getOpenAICodexRequiredScopes, getPendingSubagentResults, getPonchoStoreRoot, isMessageArray, jsonSchemaToZod, lastAssistantText, loadCanonicalHistory, loadPonchoConfig, loadRunHistory, loadSkillContext, loadSkillInstructions, loadSkillMetadata, loadSkillMetadataFromDirs, loadVfsSkillMetadata, mergeSkills, newHarnessMessagesThisTurn, normalizeApprovalCheckpoint, normalizeOtlp, normalizeScriptPolicyPath, normalizeToolAccess, parseAgentFile, parseAgentMarkdown, parseSkillFrontmatter, ponchoDocsTool, readOpenAICodexSession, readSkillResource, realResponseText, recordStandardTurnEvent, renderAgentPrompt, resolveAgentIdentity, resolveCompactionConfig, resolveEnv, resolveMemoryConfig, resolveRunRequest, resolveSkillDirs, resolveStateConfig, runConversationTurn, slugifyStorageComponent, startOpenAICodexDeviceAuth, verifyEntriesParity, verifyTenantToken, withToolResultArchiveParam, writeOpenAICodexSession };