@meistrari/remy-cli 1.18.0 → 1.19.0-rc.0

package/README.md

@@ -62,6 +62,8 @@ Subagent work appears as named **Subagent · <name>** activity rather than messa
 
 Published files and Tela Pages appear in the timeline. File artifacts include their full Web preview URL; Tela Page rows include their title and canonical URL so you can open them directly from the terminal. Remy does not request or expose the Web-only temporary iframe capability for Tela Pages.
 
+System observations appear as **system notifications** with the system actor, source, and a generic JSON data view. Remy preserves unknown actor IDs and notification formats rather than treating them as user messages or commands. When a notification starts agent work, retained history can associate it with a known accepted Remy turn without adding a synthetic prompt. Delivery is at-least-once, so an uncertain retry can produce additional distinct turns and repeat model or tool effects; Remy preserves those turns rather than presenting the association as proof of exactly-once execution. The CLI has no control for creating notifications.
+
 When Remy creates a plan, the session shows its checklist in the timeline and keeps `Plan <done>/<total>` with the current item pinned above the composer. Updates change the same checklist instead of producing repeated rows, and an unfinished plan remains visible after reconnecting or between turns. The collapsed timeline shows up to five plan items; press `Ctrl+O` for the complete checklist and activity detail.
 
 Press `Ctrl+O` to inspect tool output, including partial output from failed tools. Ordinary tools keep a single text-output block. MCP tools show ordered text and JSON blocks with separate labels; structured content appears in its own section unless it is null or absent. MCP images, audio, and embedded binary resources show media details instead of base64. Each expanded activity includes a **View event in Web** link when the server supplies its Web URL. Follow it to open the exact retained event and its output, including older or child-agent activity. The full URL remains visible for copying when your terminal does not support clickable links. Older servers without a Web URL show an explicit unavailable message instead of a guessed link. Resource links remain references, not a promise that their targets are accessible. Additional background-tool output appears as a correlated update without replacing the earlier result.

package/dist/remy.js

@@ -32249,6 +32249,27 @@ function decodeJsonKey(value) {
   return value.slice(JSON_VALIDATION_KEY_PREFIX.length);
 }
 
+// ../../packages/agents-protocol/src/agent-notification.ts
+var agentNotificationSchema = jsonValueSchema;
+var agentNotificationsSchema = zod_default2.array(agentNotificationSchema).min(1).max(20);
+var agentNotificationToolOutputMaxBytes = 64 * 1024;
+var textEncoder = new TextEncoder;
+function isAgentNotificationToolOutputWithinSizeLimit(input) {
+  return textEncoder.encode(JSON.stringify(input)).byteLength <= agentNotificationToolOutputMaxBytes;
+}
+var agentNotificationToolOutputSchema = zod_default2.object({
+  commandId: zod_default2.string().min(1),
+  notifications: agentNotificationsSchema
+}).strict().superRefine((output, context) => {
+  if (isAgentNotificationToolOutputWithinSizeLimit(output))
+    return;
+  context.addIssue({
+    code: "custom",
+    path: ["notifications"],
+    message: `Serialized notification tool output exceeds ${agentNotificationToolOutputMaxBytes} bytes.`
+  });
+});
+
 // ../../packages/agents-protocol/src/agent-user-input.ts
 var agentUserInputOptionSchema = zod_default2.object({
   value: zod_default2.string().min(1),
@@ -32297,6 +32318,23 @@ var sendPromptCommandSchema = runningCommandBaseSchema.extend({
   commandId: commandIdSchema,
   author: agentAuthorSchema.optional()
 }).strict();
+var agentNotifyCommandSchema = runningCommandBaseSchema.extend({
+  type: zod_default2.literal("agent.notify"),
+  commandId: commandIdSchema,
+  notifications: agentNotificationsSchema
+}).strict().superRefine((command, context) => {
+  if (isAgentNotificationToolOutputWithinSizeLimit({
+    commandId: command.commandId,
+    notifications: command.notifications
+  })) {
+    return;
+  }
+  context.addIssue({
+    code: "custom",
+    path: ["notifications"],
+    message: "Serialized notification tool output exceeds the allowed size."
+  });
+});
 var interruptAgentCommandSchema = runningCommandBaseSchema.extend({
   type: zod_default2.literal("agent.interrupt"),
   commandId: commandIdSchema,
@@ -32319,6 +32357,7 @@ var respondUserInputAgentCommandSchema = runningCommandBaseSchema.extend({
 }).strict();
 var agentCommandSchema = zod_default2.union([
   sendPromptCommandSchema,
+  agentNotifyCommandSchema,
   interruptAgentCommandSchema,
   compactContextAgentCommandSchema,
   stopAgentCommandSchema,
@@ -34317,6 +34356,30 @@ var sessionMessageTurnAssociatedEventSchema = exports_external2.object({
   type: exports_external2.literal("session.message.turn-associated"),
   payload: exports_external2.object({ messageId: exports_external2.string().min(1), commandId: exports_external2.string().min(1), turnId: exports_external2.string().min(1) }).passthrough()
 }).passthrough();
+var sessionNotificationCreatedEventSchema = exports_external2.strictObject({
+  type: exports_external2.literal("session.notification.created"),
+  payload: exports_external2.strictObject({
+    commandId: exports_external2.string().min(1),
+    creator: exports_external2.strictObject({
+      type: exports_external2.literal("system"),
+      id: exports_external2.string().min(1).max(80),
+      name: exports_external2.string().min(1).max(255)
+    }),
+    source: exports_external2.strictObject({
+      provider: exports_external2.string().min(1).max(50),
+      label: exports_external2.string().min(1).max(255),
+      url: exports_external2.string().nullable()
+    }),
+    notifications: exports_external2.array(jsonValueSchema).min(1).max(20)
+  })
+});
+var sessionNotificationTurnAssociatedEventSchema = exports_external2.strictObject({
+  type: exports_external2.literal("session.notification.turn-associated"),
+  payload: exports_external2.strictObject({
+    commandId: exports_external2.string().min(1),
+    turnId: exports_external2.string().min(1)
+  })
+});
 var sessionMessageDispatchEventSchema = exports_external2.object({
   type: exports_external2.enum(["session.message.dispatched", "session.message.withdrawn", "session.message.failed"]),
   payload: exports_external2.object({ messageId: exports_external2.string().min(1), commandId: exports_external2.string().min(1) }).passthrough()
@@ -34404,6 +34467,7 @@ function createSessionViewState({ detail, activeMessageId }) {
     work: { items: [] },
     workTurnBaselines: {},
     messageTurns: {},
+    notificationTurns: {},
     retainedTurnStarts: {},
     retainedTurnEnds: {},
     childLineage: {
@@ -34494,6 +34558,18 @@ function projectRetainedEvent({
       throw new SessionProjectionProtocolError("Invalid session.title.generated event.");
     return state;
   }
+  if (event.type === "session.notification.created") {
+    const notificationCreated = sessionNotificationCreatedEventSchema.safeParse(event);
+    if (!notificationCreated.success)
+      throw new SessionProjectionProtocolError("Invalid session.notification.created event.");
+    return projectSessionNotificationCreated({ state, event: notificationCreated.data, occurredAt, eventUrl });
+  }
+  if (event.type === "session.notification.turn-associated") {
+    const notificationTurnAssociated = sessionNotificationTurnAssociatedEventSchema.safeParse(event);
+    if (!notificationTurnAssociated.success)
+      throw new SessionProjectionProtocolError("Invalid session.notification.turn-associated event.");
+    return projectSessionNotificationTurnAssociated({ state, event: notificationTurnAssociated.data });
+  }
   const messageCreated = sessionMessageCreatedEventSchema.safeParse(event);
   const turnAssociated = sessionMessageTurnAssociatedEventSchema.safeParse(event);
   const messageDispatch = sessionMessageDispatchEventSchema.safeParse(event);
@@ -34530,6 +34606,42 @@ function projectRetainedEvent({
   }
   return projected;
 }
+function projectSessionNotificationCreated({
+  state,
+  event,
+  occurredAt,
+  eventUrl
+}) {
+  if (state.transcript.some((item) => item.kind === "notification" && item.commandId === event.payload.commandId))
+    return state;
+  const turnId = state.notificationTurns?.[event.payload.commandId];
+  return {
+    ...state,
+    transcript: [...state.transcript, {
+      kind: "notification",
+      commandId: event.payload.commandId,
+      ...turnId === undefined ? {} : { turnId },
+      ...eventUrl === undefined ? {} : { eventUrl },
+      occurredAt,
+      creator: event.payload.creator,
+      source: event.payload.source,
+      notifications: event.payload.notifications
+    }]
+  };
+}
+function projectSessionNotificationTurnAssociated({
+  state,
+  event
+}) {
+  return {
+    ...state,
+    notificationTurns: {
+      ...state.notificationTurns,
+      [event.payload.commandId]: event.payload.turnId
+    },
+    transcript: state.transcript.map((item) => item.kind === "notification" && item.commandId === event.payload.commandId ? { ...item, turnId: event.payload.turnId } : item)
+  };
+}
 function projectSessionMessageCreated({ state, event, occurredAt }) {
   if (state.transcript.some((item) => item.kind === "message" && item.messageId === event.payload.messageId))
     return state;
@@ -39520,6 +39632,26 @@ function renderTimeline({ state, activityExpanded }) {
 `);
 }
 function renderTimelineItem(item, activityExpanded) {
+  if (item.kind === "notification") {
+    const actorId = terminalSafeText(item.creator.id).replace(/\s+/g, " ").trim();
+    const actorName = terminalSafeText(item.creator.name).replace(/\s+/g, " ").trim() || actorId;
+    const sourceProvider = terminalSafeText(item.source.provider).replace(/\s+/g, " ").trim();
+    const sourceLabel = terminalSafeText(item.source.label).replace(/\s+/g, " ").trim() || sourceProvider;
+    const sourceUrl = item.source.url ? terminalSafeText(item.source.url) : null;
+    const notificationData = JSON.stringify(item.notifications, null, 2);
+    return joinStyled([
+      new StyledText8([
+        renderTimestampChunk(item.occurredAt),
+        renderRoleLabel({ label: actorName, role: "system" }),
+        dim7(fg10(PALETTE.dimText)(` \xB7 System notification (${sourceLabel})`))
+      ]),
+      new StyledText8([dim7(fg10(PALETTE.dimText)(`Actor ID: ${actorId} \xB7 Source: ${sourceProvider}`))]),
+      ...sourceUrl ? [new StyledText8([dim7(fg10(PALETTE.dimText)(`Source URL: ${sourceUrl}`))])] : [],
+      new StyledText8([fg10(PALETTE.dimText)(notificationData)]),
+      ...item.eventUrl ? [new StyledText8([dim7(fg10(PALETTE.dimText)(`View event in Web: ${item.eventUrl}`))])] : []
+    ], `
+`);
+  }
   if (item.kind === "message") {
     const header = new StyledText8([
       renderTimestampChunk(item.occurredAt),
@@ -40134,7 +40266,7 @@ var compactMarkRows = 9;
 var compactMinWidth = 48;
 var compactMinHeight = 20;
 var markBrightnessGain = 4.2;
-var remyCliVersion = "1.18.0";
+var remyCliVersion = "1.19.0-rc.0";
 async function showRemySplash({
   createRenderer = createRemyRenderer,
   durationMs = splashDurationMs,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@meistrari/remy-cli",
-    "version": "1.18.0",
+    "version": "1.19.0-rc.0",
     "description": "Remy, the Coding Agent terminal client.",
     "type": "module",
     "bin": {