ptr.pet / prime-commitment-observer
watches turns and automatically creates and resolves tasks that get pinned into main agent context
Star 0
Fork 0
Watch
TypeScript 76%
Python 24%
14 1 0
observer-bench
src
test
.gitignore
index.ts
package-lock.json
package.json
README.md
tsconfig.check.json
tsconfig.json
tsconfig.live.json
README.md

prime-commitment-observer #

A Prime Agent extension that remembers unfinished user requests across turns without making the foreground model manage a task registry.

behavior #

The extension keeps one append-only, branch-aware ledger in the session file. A small observer model runs after completed agent turns and classifies each request as open, active, waiting, blocked, done, cancelled, or superseded.

Before a user-originated turn, Prime receives one hidden <pending_requests> context block when the pending set changed. Internal wakes such as child completion notices and background command completions never create another block. Closing the final request emits one clear marker so an older snapshot cannot remain authoritative.

This is a lightweight semantic ledger. It does not infer test results or claim verified completion from command strings. The observer judges the user messages and the completed assistant response.

requirements #

This version requires a Prime Agent build whose before_agent_start extension event includes source. The extension uses it to distinguish user input from internal wakes.

install #

From a clone:

git clone git@knot.gaze.systems:did:plc:gyggh67fdq2hukuabczwhm3w prime-commitment-observer
cd prime-commitment-observer
prime-agent package install .

The package manager records the checkout in ~/.prime/agent/settings.json. Keep the checkout in place while it is installed. Reload extensions or restart Prime Agent.

configuration #

export PRIME_COMMITMENT_OBSERVER_PROVIDER=deepseek
export PRIME_COMMITMENT_OBSERVER_MODEL=deepseek-v4-flash
export PRIME_COMMITMENT_OBSERVER_TIMEOUT_MS=60000

Optional variables:

  • PRIME_COMMITMENT_OBSERVER_API_KEY
  • PRIME_COMMITMENT_OBSERVER_BASE_URL
  • PRIME_COMMITMENT_OBSERVER_TEMPERATURE
  • PRIME_COMMITMENT_OBSERVER_MAX_TOKENS

Without an explicit API key, the observer uses Prime Agent's configured credentials.

manual control #

/threads lists the ledger. Manual mutations stay in the extension command surface:

/threads done <id>
/threads dismiss <id> [reason]
/threads reopen <id>
/threads drop <id>
/threads edit <id> <request>
/threads reconcile

The foreground model is not given thread ids and has no threads skill.

development #

npm test
npm run check