imccyu
970b432227
set() on an idle agent appends plan/mode at once — no request boundary would arrive until the next prompt, so a queued intent used to hang as pending forever (the composer showed a dead pending target). A running agent keeps the boundary-flush path unchanged. set() now reports which branch ran (committed/queued/cancelled/noop); the /plan handler's copy follows the branch (idle: "Plan mode on/off", mid-turn: the next-step wording), and both commit paths share the header-delta narration. The invariant drops turn enclosure: plan/mode is a standalone whole-value event (the synthetic log-only turns removal already established the between-turns append shape). The fixture mirrors the idle commit.
49 lines
2.1 KiB
TypeScript
49 lines
2.1 KiB
TypeScript
/** Package-owned durable plan-mode invariants. @module @deepseek-ai/dsh-plan-mode/invariant */
|
|
|
|
import type { Context } from 'cordis'
|
|
import type { Session, SessionEvent } from '@deepseek-ai/dsh-session'
|
|
import type { InvariantFailure, InvariantInstaller } from '@deepseek-ai/dsh-invariants'
|
|
|
|
const PACKAGE_NAME = '@deepseek-ai/dsh-plan-mode'
|
|
|
|
/** Cordis companion plugin name. */
|
|
export const name = 'plan-mode-invariant'
|
|
/** Service required before the companion can reserve package ownership. */
|
|
export const inject = ['invariants']
|
|
|
|
/**
|
|
* Validate one `plan/mode` event before it reaches the durable log.
|
|
* `plan/mode` is a standalone whole-value event: an idle selection commits
|
|
* between turns and a mid-turn selection commits at the step boundary, so
|
|
* no turn-enclosure relation exists — only the payload shape is checkable.
|
|
*/
|
|
function validateEvent(event: SessionEvent, fail: InvariantFailure): void {
|
|
if (event.type !== 'plan/mode') return
|
|
const active = (event.data as { active?: unknown }).active
|
|
if (typeof active !== 'boolean') {
|
|
fail(`plan/mode carries invalid active state ${JSON.stringify(active)}; expected a boolean`)
|
|
}
|
|
}
|
|
|
|
/** Install validation for loaded and newly appended plan-mode state. */
|
|
const install: InvariantInstaller = Object.assign((ctx: Context, fail: InvariantFailure) => {
|
|
const seed = (session: Session): void => {
|
|
for (const event of session.events) validateEvent(event, fail)
|
|
}
|
|
for (const session of ctx.sessions.list()) seed(session)
|
|
ctx.on('session/created', (session) => { seed(session) }, { global: true })
|
|
ctx.on('internal/dispatch', (_mode, eventName, args) => {
|
|
if (eventName !== 'session/event') return
|
|
const [, event] = args as [Session, SessionEvent]
|
|
validateEvent(event, fail)
|
|
}, { global: true })
|
|
}, { inject: ['sessions'] })
|
|
|
|
/**
|
|
* Register the plan-mode invariant companion.
|
|
* @param ctx - Cordis context carrying the invariant service.
|
|
* @returns the installed registration's disposer after setup succeeds.
|
|
*/
|
|
export const apply = (ctx: Context): Promise<() => void> =>
|
|
Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install))
|