Skip to content

The open-source agent harness - the runtime layer that turns an LLM into a working agent.

Reject undefined capability state at the persist boundary.

debajyoti-truefoundrye2b72ccacdba
diff --git a/packages/harness/src/agent-session/TurnHandle.ts b/packages/harness/src/agent-session/TurnHandle.ts
index 76b552c43..9de21185e 100644
--- a/packages/harness/src/agent-session/TurnHandle.ts
+++ b/packages/harness/src/agent-session/TurnHandle.ts
@@ -1,6 +1,7 @@
/**
* Durable turn handle. {@link TurnHandle.stream} is execute-once (persist-before-yield).
*/
+import { AgentHarnessError } from '../core/errors';
import type { MCPAuthRequiredEvent, ModelMessageDeltaEvent, ThreadDoneEvent } from '../core/events/schema';
import { EventType as HarnessEventType, newEventId } from '../core/events/schema';
import { getEmptyUsage } from '../core/llm/LLMTypes';
@@ -336,6 +337,14 @@ export class TurnHandle<TTurnCustom extends object = Record<string, never>> {
return null;
case InternalEventType.CAPABILITY_STATE: {
+ // Persist boundary: types exclude undefined; reject it at runtime so stores never see it.
+ const state: unknown = event.state;
+ if (state === undefined) {
+ throw new AgentHarnessError(
+ 'capability_state_error',
+ `CAPABILITY_STATE for key '${event.key}' must not be undefined — use null to clear durable state`,
+ );
+ }
await this.store.patchThreadCapabilityState({
...scope,
thread_id: event.thread_id,