omp packages

pi-invisible-continue0.3.18

Invisible session continuation for pi — resume the agentic loop without sending ANY prompt the LLM can see

GitHub Actions Published 3 days ago MIT ~2.8K downloads/mo

Untested on omp

This is a pi package. No one has reported whether it works on omp yet. If you try it, add your result below.

Did it work for you?

Result

One report per person. A new report replaces your old one.

Reports 0

No reports yet.

Readme

👻 pi-invisible-continue

Invisible session continuation for pi

Resume the agentic loop without the LLM seeing a new prompt.

pi extension license


Pi 1.0 compatibility (0.3.15)

Tested with Pi 1.0.0. Host-provided Pi packages and TypeBox are peers (*), not bundled runtime dependencies; development uses exact Pi 1.0.0 pins and host-compatible TypeBox where needed.

Invisible continuation retains Pi's native session queues and strips only its hidden marker from provider context; native system/tool declarations remain intact.

Run bun run test:host for the offline real-host load, native codemode/nested-call, module-identity and reload checks. Set PI1_HOST_PACKAGE to an installed Pi package directory to test that host explicitly; add PI1_HOST_ENTRY=bundle to check the bundled CLI runtime's constructors.

The Problem

Most “continue” extensions send user text to the LLM:

Package What the LLM sees
pi-continue A full handoff document
pi-hodor "continue"
pi-auto-continue "continue"

That text can influence the next response or be interpreted as a new task.

The Solution

pi-invisible-continue starts a normal Pi session turn with a hidden custom marker. A context hook removes that marker before provider serialization, so the LLM receives no new prompt text.

The continuation deliberately goes through AgentSession:

  • Pi’s session-level busy state remains accurate.
  • A concurrent prompt is queued through the native follow-up path rather than racing it.
  • Auto-retry, compaction, abort, and agent_settled behavior remain intact.
  • The marker is hidden from the TUI and filtered from every LLM request.
  • When a continuation starts after pi's auto-retry is exhausted, the trailing failed assistant attempts (stopReason: "error"/"aborted", no tool calls) are also dropped from the request — the LLM never sees the failure either.

How It Works

/continue calls:

pi.sendMessage(
  {
    customType: "pi-invisible-continue:resume",
    content: [],
    display: false,
  },
  {
    triggerTurn: true,
    deliverAs: "followUp",
  },
);

Pi starts the turn immediately when idle or queues it when another turn is active. Before the provider request, the extension removes its custom marker from event.messages.

Why not Agent.prompt([])?

Calling the low-level agent directly bypasses AgentSession._runAgentPrompt(). Pi can then report the session as idle while Agent.activeRun is already processing. A user prompt may be routed as a fresh prompt and fail with:

Agent is already processing a prompt. Use steer() or followUp() to queue messages, or wait for completion.

Using sendMessage keeps one authoritative lifecycle and avoids that split-brain busy state.

Session artifact

The session journal contains one hidden custom entry per continuation. It has no display content and is removed before every provider call, but it is still bookkeeping in the saved session. This is the correctness trade-off until Pi exposes a public session-level resume API that adds no entry.

Usage

Command What it does
/continue Start or queue an invisible continuation.
/continue status Show session idle state and the last assistant text.
/continue help Show the command reference.

Installation

pi install npm:pi-invisible-continue

Or install from GitHub:

pi install https://github.com/monotykamary/pi-invisible-continue

Or add it to ~/.pi/agent/settings.json:

{
  "packages": [
    "https://github.com/monotykamary/pi-invisible-continue"
  ]
}

Then run /reload or restart Pi.

For a one-off test:

pi -e ./continue.ts

Comparison

Feature pi-invisible-continue pi-continue pi-hodor pi-auto-continue
LLM sees new user text No Handoff doc "continue" "continue"
Visible transcript entry No Yes Yes Yes
Hidden session bookkeeping One custom entry Compaction + user entry User entry User entry
Native session lifecycle Yes Yes Yes Yes
Auto-triggered No On compaction On error/length On agent_end

The desired upstream primitive is a public AgentSession.resume() operation that preserves native lifecycle behavior without adding a marker. Until then, a filtered custom message is safer than bypassing the session.

License

MIT