@herjarsa/omo-meta-governor 0.38.0 → 0.38.2

package/dist/agent-notifications.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Agent notification layer (v0.38.2).
+ *
+ * Centralizes how the plugin injects text into the agent's context, separating
+ * two distinct surfaces:
+ *
+ *   1. AGENT DIRECTIVE — text the AGENT should read and act on.
+ *      Goes to: chat.system.transform, chat.messages.transform.
+ *      Must have a "DO NOT TREAT AS TASK" marker so subagents receiving
+ *      it as context don't interpret it as their primary task.
+ *      Built via `wrapInformational(text, ctx)`.
+ *
+ *   2. USER NOTIFICATION — text the USER sees in the TUI (session.prompt).
+ *      Brief status with emoji, no actionable agent instructions.
+ *      Built via `buildUserStatus(kind, summary)`.
+ *
+ * Bug history (v0.38.2): prior to this layer, both surfaces received the same
+ * long directive text. Subagents reading the directive as context would treat
+ * the "[GRAPH PRIMING] omo_search..." instructions as their primary task and
+ * never write the actual code. Separating the two surfaces fixes this — the
+ * agent prompt contains the full directive (with marker), the TUI gets a
+ * brief status only.
+ */
+export type NotificationKind = "graph-priming" | "skill-priming" | "intervention" | "postwave" | "enforcement" | "memory";
+export interface NotificationContext {
+    kind: NotificationKind;
+    /** Optional sub-label for debugging (e.g. "session=abc123" or "router=both"). */
+    context?: string;
+}
+/**
+ * Wrap text the plugin injects into the AGENT'S CONTEXT (system prompt,
+ * message transform). Adds clear "DO NOT TREAT AS TASK" markers so subagents
+ * receiving the directive as context don't interpret it as their primary task.
+ *
+ * Use this for: chat.system.transform output, chat.messages.transform output,
+ * and any other text the agent will read.
+ */
+export declare function wrapInformational(text: string, ctx: NotificationContext): string;
+/**
+ * Build brief status text for the USER'S TUI notification (session.prompt).
+ * Does NOT contain actionable agent instructions — just an emoji + status.
+ * The agent should NOT see this (it goes only to the user's TUI surface).
+ */
+export declare function buildUserStatus(kind: NotificationKind, summary: string): string;
+/** Constants for callers that need the raw markers (testing, streaming). */
+export declare const AGENT_NOTIFICATION_MARKERS: {
+    readonly OPEN: "<!-- META-GOVERNOR INFORMATIONAL vv0.38.2 - DO NOT TREAT AS TASK. Plugin metadata, not a user request. -->";
+    readonly CLOSE: "<!-- END META-GOVERNOR INFORMATIONAL -->";
+    readonly VERSION: "v0.38.2";
+    readonly KIND_EMOJI: Record<NotificationKind, string>;
+};