billion-context-pi 0.1.82 → 0.1.83

package/dist/messages.d.ts

@@ -13,6 +13,13 @@ export declare const ACP_EXPORT_CUSTOM_TYPE = "acp-export";
  *  reach the model through the feature's own channel, so the human-facing
  *  report must never be re-billed as model context. */
 export declare const ACP_RULE_CUSTOM_TYPE = "acp-rule";
+/** Nudge persistence record (issue #326): written via pi.appendEntry as a
+ *  type:"custom" entry — never projected into the sent view (see above), so
+ *  the compact one-liner stays out of model context while surviving restarts. */
+export declare const ACP_NUDGE_CUSTOM_TYPE = "acp-nudge";
+export interface AcpNudgeRecord {
+    text: string;
+}
 /** True for host-injected custom_message entries that participate in LLM
  *  context: non-empty custom_message except the UI-only types in
  *  CONTEXT_EXCLUDED_CUSTOM_TYPES (acp-status panels, acp-export docs,

package/dist/runtime.d.ts

@@ -68,6 +68,11 @@ export interface AcpRuntime {
     nudgeShownTokensFor(sid: string, turnKey: string): number | undefined;
     /** Clears the token-count stamps recorded by markNudgeShown — used on a token-scale flip (issue #267) so the same-turn re-inject floor (#269 / PR #316) is not computed against an old-scale stamp. */
     clearNudgeTokenStamps(sid: string): void;
+    /** Like the nudgeShown* pair but tracks the persisted display-only session
+     *  entry (issue #326): at most one record per user turn even when the
+     *  emergency nudge re-injects on every LLM call. */
+    markNudgeRecorded(sid: string, turnKey: string): void;
+    nudgeRecordedFor(sid: string, turnKey: string): boolean;
     /** Process compress toolResults for the CURRENT user turn only (the caller
      *  scopes the list — see collectCompressOutcomes in src/index.ts); idempotent
      *  per toolCallId. turnKey MUST be the stable persisted-boundary key

package/dist/session-log.d.ts

@@ -10,3 +10,14 @@ export declare function parseSessionLog(text: string): SessionEntry[];
  *  returns entries whose base id is in `wantedBaseIds`. The starting session
  *  itself is never included; nearest-ancestor entries win on duplicate ids. */
 export declare function loadAncestorEntries(sessionFile: string | undefined, wantedBaseIds: Set<string>): Promise<SessionEntry[]>;
+/** Read-only content recovery for content-addressed `live-*` refs (issue
+ *  #579): fork hosts alias not-yet-persisted tail messages with `live-*` ids
+ *  (runtime.ts mergeLiveEntries); those aliases appear in NO jsonl, so the
+ *  entry-id lookup above can never find them. The rawId→identity bridge lives
+ *  in each session's OWN sidecar (liveRefOrigins). Walks the chain — itself
+ *  first, then ancestors, same depth/cycle rules as loadAncestorEntries — and
+ *  at each level pairs that level's declared origins with that same level's
+ *  log entries matched by messageIdentity. First matching entry wins per rawId
+ *  (identical identities are interchangeable: identity covers full normalized
+ *  content). Never writes any sidecar. */
+export declare function loadLiveRefEntries(sessionFile: string | undefined, wantedRawIds: Set<string>): Promise<Map<string, SessionEntry>>;

package/dist/state.d.ts

@@ -1,4 +1,5 @@
 import { type CompressionState } from "acp-kernel";
+export declare const STATE_SUFFIX = ".acp.json";
 export interface LiveRefOrigin {
     rawId: string;
     identity: string;
@@ -38,3 +39,4 @@ export declare class SessionStateStore {
  *  use this: their session files carry a parentSession header that already
  *  inherits the parent state verbatim. */
 export declare function deriveChildState(parent: CompressionState): CompressionState;
+export declare function parseLiveRefOrigins(value: unknown): LiveRefOrigin[];

package/dist/turn-boundary.d.ts

@@ -27,10 +27,20 @@ export interface TurnBoundaryEntry {
  *  standalone pi users' nudge cadence unchanged. */
 export interface TurnBoundaryPolicy {
     countCustomMessages?: boolean;
+    /** #578: optional customType allowlist refining countCustomMessages. When
+     *  set, only injected entries whose customType is listed delimit turns —
+     *  host metadata injections (harness_digest, ipython_state, …) that enter
+     *  LLM context without being a real host turn stay out of turn accounting.
+     *  Unset = every non-empty injected message counts (pre-#578 behavior).
+     *  Entries without a customType never match; UI-only types stay excluded
+     *  even when listed. Ignored unless countCustomMessages is true. */
+    customMessageTypes?: readonly string[];
 }
 /** The ONE turn-boundary predicate (#364): does this entry start a new turn?
  *  Genuine user-role messages always do (pi-native); host-injected
- *  custom_message entries do only when the host opts in via policy. */
+ *  custom_message entries do only when the host opts in via policy, optionally
+ *  refined by a customMessageTypes allowlist so metadata injections
+ *  (harness_digest, ipython_state) stay out of turn accounting (#578). */
 export declare function isTurnBoundary(entry: TurnBoundaryEntry, policy?: TurnBoundaryPolicy): boolean;
 /** Id of the last turn-boundary entry — the per-turn key for nudge
  *  accounting, retry caps and outcome scoping. Defaults to pi-native

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "billion-context-pi",
-	"version": "0.1.82",
+	"version": "0.1.83",
 	"description": "One billion, not one million. Model-driven context management for the Pi coding agent.",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",