fix(protocol): allow paperclip field in AgentParamsSchema

Linux2010 · Linux2010 · commit 9406acc1a3b2 · 2026-04-30T10:23:42.000Z
Paperclip agent injects a 'paperclip' property into agent invocation payloads, but gateway validation rejects unknown fields due to additionalProperties: false. Add optional paperclip field to allow third-party integrations without breaking validation. Fixes #74635
diff --git a/src/gateway/protocol/schema/agent.ts b/src/gateway/protocol/schema/agent.ts
@@ -173,6 +173,9 @@ export const AgentParamsSchema = Type.Object(
     voiceWakeTrigger: Type.Optional(Type.String()),
     idempotencyKey: NonEmptyString,
     label: Type.Optional(SessionLabelString),
+    // Allow Paperclip and other third-party integrations to pass runtime context
+    // without breaking gateway validation. Gateway accepts but ignores this field.
+    paperclip: Type.Optional(Type.Unknown()),
   },
   { additionalProperties: false },
 );
