@stndrds/schema 1.0.0-alpha.338 → 1.0.0-alpha.342

package/dist/index.d.mts

@@ -2310,6 +2310,20 @@ export type AIChatMessagePart = {
  * notification. `completed` reads as success; everything else reads as failure.
  */
 export type AISubagentStatus = "completed" | "failed" | "cancelled" | "timeout" | "expired";
+/**
+ * `metadata.kind` of the `user` row the backend appends to a parent session when
+ * a dispatched child finishes. It is delivered by its own mechanism and is NEVER
+ * a waiting message: a person did not send it, and the agent's read watermark
+ * ignores it. Every reader that decides "is this message waiting" reaches the
+ * rule here: the SQL predicate (`waitingUserMessage` in the Postgres
+ * repository) binds {@link AGENT_NOTIFICATION_KIND} as a query parameter; the
+ * runtime mock and the client readers call {@link isAgentNotificationMetadata}.
+ * A contract test in the runtime keeps the literal out of everywhere else
+ * (#3792).
+ */
+export declare const AGENT_NOTIFICATION_KIND = "agent-notification";
+/** Whether a message's metadata marks it as a subagent notification. */
+export declare function isAgentNotificationMetadata(metadata: Readonly<Record<string, unknown>> | null | undefined): boolean;
 /**
  * Narrow, UI-ready projection of an `agent-notification` message. Derived by the
  * react mapper from the raw `AgentSessionMessage.metadata` so the UI never has to

package/dist/index.d.ts

@@ -2310,6 +2310,20 @@ export type AIChatMessagePart = {
  * notification. `completed` reads as success; everything else reads as failure.
  */
 export type AISubagentStatus = "completed" | "failed" | "cancelled" | "timeout" | "expired";
+/**
+ * `metadata.kind` of the `user` row the backend appends to a parent session when
+ * a dispatched child finishes. It is delivered by its own mechanism and is NEVER
+ * a waiting message: a person did not send it, and the agent's read watermark
+ * ignores it. Every reader that decides "is this message waiting" reaches the
+ * rule here: the SQL predicate (`waitingUserMessage` in the Postgres
+ * repository) binds {@link AGENT_NOTIFICATION_KIND} as a query parameter; the
+ * runtime mock and the client readers call {@link isAgentNotificationMetadata}.
+ * A contract test in the runtime keeps the literal out of everywhere else
+ * (#3792).
+ */
+export declare const AGENT_NOTIFICATION_KIND = "agent-notification";
+/** Whether a message's metadata marks it as a subagent notification. */
+export declare function isAgentNotificationMetadata(metadata: Readonly<Record<string, unknown>> | null | undefined): boolean;
 /**
  * Narrow, UI-ready projection of an `agent-notification` message. Derived by the
  * react mapper from the raw `AgentSessionMessage.metadata` so the UI never has to