@noodleseed/one 0.177.0 → 0.178.0

package/node_modules/@noodle-borg/wire-contracts/dist/assistant.d.ts

@@ -31,6 +31,9 @@ export declare const assistantSessionResponseSchema: z.ZodObject<{
         tool: z.ZodString;
     }, z.core.$strip>>;
     continuedAfterAuthentication: z.ZodOptional<z.ZodLiteral<true>>;
+    history: z.ZodOptional<z.ZodObject<{
+        retentionDays: z.ZodNumber;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type AssistantSessionResponse = z.infer<typeof assistantSessionResponseSchema>;
 /** MCP-Apps-shaped, author-selected renderer summary included on one assistant turn. */

package/node_modules/@noodle-borg/wire-contracts/dist/assistant.js

@@ -61,6 +61,12 @@ export const assistantSessionResponseSchema = z.object({
     resume: z.object({ tool: z.string().min(1) }).optional(),
     /** Additive elevation marker; the client renders one bounded continuation status. */
     continuedAfterAuthentication: z.literal(true).optional(),
+    /**
+     * Additive retention notice (ADR 0241 decision 17): present only when this caller's conversation
+     * is recorded. Top level, never inside `configuration`, whose strict browser schema would make an
+     * older widget drop its whole appearance; older widgets ignore unknown top-level keys.
+     */
+    history: z.object({ retentionDays: z.number().int().min(1).max(365) }).optional(),
 });
 const recoverableViewSchema = z
     .object({

package/node_modules/@noodle-borg/wire-contracts/dist/conversation-history.d.ts

@@ -8,6 +8,13 @@ export declare const ConversationChannelSchema: z.ZodEnum<{
     whatsapp: "whatsapp";
     website: "website";
 }>;
+/** Staff review state; a failed tool outcome sets `needs_attention` automatically. */
+export declare const ConversationReviewStatusSchema: z.ZodEnum<{
+    new: "new";
+    needs_attention: "needs_attention";
+    reviewed: "reviewed";
+}>;
+export type ConversationReviewStatus = z.infer<typeof ConversationReviewStatusSchema>;
 export declare const ConversationSummarySchema: z.ZodObject<{
     id: z.ZodString;
     channel: z.ZodEnum<{
@@ -26,6 +33,11 @@ export declare const ConversationSummarySchema: z.ZodObject<{
     startedAt: z.ZodISODateTime;
     lastMessageAt: z.ZodISODateTime;
     itemCount: z.ZodNumber;
+    reviewStatus: z.ZodEnum<{
+        new: "new";
+        needs_attention: "needs_attention";
+        reviewed: "reviewed";
+    }>;
 }, z.core.$strict>;
 export declare const ConversationItemSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"message">;
@@ -48,6 +60,64 @@ export declare const ConversationItemSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
     at: z.ZodISODateTime;
 }, z.core.$strict>], "kind">;
 export declare const ConversationDetailSchema: z.ZodObject<{
+    expiresAt: z.ZodISODateTime;
+    items: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"message">;
+        role: z.ZodEnum<{
+            assistant: "assistant";
+            user: "user";
+        }>;
+        text: z.ZodString;
+        at: z.ZodISODateTime;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"outcome">;
+        interactionId: z.ZodString;
+        tool: z.ZodString;
+        status: z.ZodEnum<{
+            failed: "failed";
+            succeeded: "succeeded";
+            declined: "declined";
+            cancelled: "cancelled";
+        }>;
+        at: z.ZodISODateTime;
+    }, z.core.$strict>], "kind">>;
+    id: z.ZodString;
+    channel: z.ZodEnum<{
+        whatsapp: "whatsapp";
+        website: "website";
+    }>;
+    subject: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"anonymous">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"customer">;
+        ref: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"participant">;
+        ref: z.ZodString;
+    }, z.core.$strict>], "kind">;
+    startedAt: z.ZodISODateTime;
+    lastMessageAt: z.ZodISODateTime;
+    itemCount: z.ZodNumber;
+    reviewStatus: z.ZodEnum<{
+        new: "new";
+        needs_attention: "needs_attention";
+        reviewed: "reviewed";
+    }>;
+}, z.core.$strict>;
+/** A private staff note: never sent to the customer, never exported, removed with its conversation. */
+export declare const ConversationNoteSchema: z.ZodObject<{
+    author: z.ZodString;
+    text: z.ZodString;
+    at: z.ZodISODateTime;
+}, z.core.$strict>;
+/** Show adds the private notes that export leaves out. */
+export declare const ConversationShowSchema: z.ZodObject<{
+    notes: z.ZodArray<z.ZodObject<{
+        author: z.ZodString;
+        text: z.ZodString;
+        at: z.ZodISODateTime;
+    }, z.core.$strict>>;
+    expiresAt: z.ZodISODateTime;
     items: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"message">;
         role: z.ZodEnum<{
@@ -85,6 +155,11 @@ export declare const ConversationDetailSchema: z.ZodObject<{
     startedAt: z.ZodISODateTime;
     lastMessageAt: z.ZodISODateTime;
     itemCount: z.ZodNumber;
+    reviewStatus: z.ZodEnum<{
+        new: "new";
+        needs_attention: "needs_attention";
+        reviewed: "reviewed";
+    }>;
 }, z.core.$strict>;
 export declare const ConversationListResponseSchema: z.ZodObject<{
     ok: z.ZodLiteral<true>;
@@ -107,14 +182,26 @@ export declare const ConversationListResponseSchema: z.ZodObject<{
             startedAt: z.ZodISODateTime;
             lastMessageAt: z.ZodISODateTime;
             itemCount: z.ZodNumber;
+            reviewStatus: z.ZodEnum<{
+                new: "new";
+                needs_attention: "needs_attention";
+                reviewed: "reviewed";
+            }>;
         }, z.core.$strict>>;
         nextCursor: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>;
 }, z.core.$strict>;
+/** Show and review both answer with the conversation as staff now see it. */
 export declare const ConversationShowResponseSchema: z.ZodObject<{
     ok: z.ZodLiteral<true>;
     data: z.ZodObject<{
         conversation: z.ZodObject<{
+            notes: z.ZodArray<z.ZodObject<{
+                author: z.ZodString;
+                text: z.ZodString;
+                at: z.ZodISODateTime;
+            }, z.core.$strict>>;
+            expiresAt: z.ZodISODateTime;
             items: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"message">;
                 role: z.ZodEnum<{
@@ -152,13 +239,29 @@ export declare const ConversationShowResponseSchema: z.ZodObject<{
             startedAt: z.ZodISODateTime;
             lastMessageAt: z.ZodISODateTime;
             itemCount: z.ZodNumber;
+            reviewStatus: z.ZodEnum<{
+                new: "new";
+                needs_attention: "needs_attention";
+                reviewed: "reviewed";
+            }>;
         }, z.core.$strict>;
     }, z.core.$strict>;
 }, z.core.$strict>;
+/** Review status needs `records:status`, a note `records:note`; at least one is required. */
+export declare const ConversationReviewRequestSchema: z.ZodObject<{
+    reviewStatus: z.ZodOptional<z.ZodEnum<{
+        new: "new";
+        needs_attention: "needs_attention";
+        reviewed: "reviewed";
+    }>>;
+    note: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ConversationReviewRequest = z.infer<typeof ConversationReviewRequestSchema>;
 export declare const ConversationExportResponseSchema: z.ZodObject<{
     ok: z.ZodLiteral<true>;
     data: z.ZodObject<{
         conversations: z.ZodArray<z.ZodObject<{
+            expiresAt: z.ZodISODateTime;
             items: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"message">;
                 role: z.ZodEnum<{
@@ -196,6 +299,11 @@ export declare const ConversationExportResponseSchema: z.ZodObject<{
             startedAt: z.ZodISODateTime;
             lastMessageAt: z.ZodISODateTime;
             itemCount: z.ZodNumber;
+            reviewStatus: z.ZodEnum<{
+                new: "new";
+                needs_attention: "needs_attention";
+                reviewed: "reviewed";
+            }>;
         }, z.core.$strict>>;
         nextCursor: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>;
@@ -242,6 +350,11 @@ export declare const ConversationListClientResponseSchema: z.ZodObject<{
             startedAt: z.ZodISODateTime;
             lastMessageAt: z.ZodISODateTime;
             itemCount: z.ZodNumber;
+            reviewStatus: z.ZodEnum<{
+                new: "new";
+                needs_attention: "needs_attention";
+                reviewed: "reviewed";
+            }>;
         }, z.core.$strip>>;
         nextCursor: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
@@ -250,6 +363,12 @@ export declare const ConversationShowClientResponseSchema: z.ZodObject<{
     ok: z.ZodLiteral<true>;
     data: z.ZodObject<{
         conversation: z.ZodObject<{
+            notes: z.ZodArray<z.ZodObject<{
+                author: z.ZodString;
+                text: z.ZodString;
+                at: z.ZodISODateTime;
+            }, z.core.$strip>>;
+            expiresAt: z.ZodISODateTime;
             items: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"message">;
                 role: z.ZodEnum<{
@@ -287,6 +406,11 @@ export declare const ConversationShowClientResponseSchema: z.ZodObject<{
             startedAt: z.ZodISODateTime;
             lastMessageAt: z.ZodISODateTime;
             itemCount: z.ZodNumber;
+            reviewStatus: z.ZodEnum<{
+                new: "new";
+                needs_attention: "needs_attention";
+                reviewed: "reviewed";
+            }>;
         }, z.core.$strip>;
     }, z.core.$strip>;
 }, z.core.$strip>;
@@ -294,6 +418,7 @@ export declare const ConversationExportClientResponseSchema: z.ZodObject<{
     ok: z.ZodLiteral<true>;
     data: z.ZodObject<{
         conversations: z.ZodArray<z.ZodObject<{
+            expiresAt: z.ZodISODateTime;
             items: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"message">;
                 role: z.ZodEnum<{
@@ -331,6 +456,11 @@ export declare const ConversationExportClientResponseSchema: z.ZodObject<{
             startedAt: z.ZodISODateTime;
             lastMessageAt: z.ZodISODateTime;
             itemCount: z.ZodNumber;
+            reviewStatus: z.ZodEnum<{
+                new: "new";
+                needs_attention: "needs_attention";
+                reviewed: "reviewed";
+            }>;
         }, z.core.$strip>>;
         nextCursor: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
@@ -344,4 +474,50 @@ export declare const ConversationForgetClientResponseSchema: z.ZodObject<{
         }, z.core.$strip>;
     }, z.core.$strip>;
 }, z.core.$strip>;
+export declare const ASSISTANT_CONVERSATION_PAGE_MAXIMUM = 50;
+export declare const ASSISTANT_CONVERSATION_PREVIEW_MAXIMUM = 120;
+export declare const AssistantConversationListRequestSchema: z.ZodObject<{
+    user: z.ZodObject<{
+        id: z.ZodString;
+    }, z.core.$strict>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const AssistantConversationForgetUserRequestSchema: z.ZodObject<{
+    user: z.ZodObject<{
+        id: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const AssistantConversationListResponseSchema: z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        conversations: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            channel: z.ZodEnum<{
+                whatsapp: "whatsapp";
+                website: "website";
+            }>;
+            startedAt: z.ZodISODateTime;
+            lastMessageAt: z.ZodISODateTime;
+            preview: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        nextCursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const AssistantConversationListClientResponseSchema: z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    data: z.ZodObject<{
+        conversations: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            channel: z.ZodEnum<{
+                whatsapp: "whatsapp";
+                website: "website";
+            }>;
+            startedAt: z.ZodISODateTime;
+            lastMessageAt: z.ZodISODateTime;
+            preview: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        nextCursor: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
 //# sourceMappingURL=conversation-history.d.ts.map

package/node_modules/@noodle-borg/wire-contracts/dist/conversation-history.js

@@ -5,6 +5,8 @@ import { z } from 'zod';
  */
 export const ConversationIdSchema = z.string().regex(/^cv_[A-Za-z0-9_-]{8,64}$/);
 export const ConversationChannelSchema = z.enum(['website', 'whatsapp']);
+/** Staff review state; a failed tool outcome sets `needs_attention` automatically. */
+export const ConversationReviewStatusSchema = z.enum(['new', 'needs_attention', 'reviewed']);
 const SubjectRefSchema = z.string().min(1).max(256);
 /** Anonymous handles never leave the service; verified subjects carry the reference forget uses. */
 const ConversationSubjectSchema = z.discriminatedUnion('kind', [
@@ -19,6 +21,7 @@ export const ConversationSummarySchema = z.strictObject({
     startedAt: z.iso.datetime(),
     lastMessageAt: z.iso.datetime(),
     itemCount: z.number().int().min(1),
+    reviewStatus: ConversationReviewStatusSchema,
 });
 export const ConversationItemSchema = z.discriminatedUnion('kind', [
     z.strictObject({
@@ -37,8 +40,22 @@ export const ConversationItemSchema = z.discriminatedUnion('kind', [
 ]);
 export const ConversationDetailSchema = z.strictObject({
     ...ConversationSummarySchema.shape,
+    /** When the last visible item is removed automatically under the live retention window. */
+    expiresAt: z.iso.datetime(),
     items: z.array(ConversationItemSchema).max(10_000),
 });
+const NoteTextSchema = z.string().trim().min(1).max(2000);
+/** A private staff note: never sent to the customer, never exported, removed with its conversation. */
+export const ConversationNoteSchema = z.strictObject({
+    author: z.string().min(1).max(500),
+    text: NoteTextSchema,
+    at: z.iso.datetime(),
+});
+/** Show adds the private notes that export leaves out. */
+export const ConversationShowSchema = z.strictObject({
+    ...ConversationDetailSchema.shape,
+    notes: z.array(ConversationNoteSchema).max(100),
+});
 const NextCursorSchema = z.string().min(1).max(2048);
 export const ConversationListResponseSchema = z.strictObject({
     ok: z.literal(true),
@@ -47,9 +64,19 @@ export const ConversationListResponseSchema = z.strictObject({
         nextCursor: NextCursorSchema.optional(),
     }),
 });
+/** Show and review both answer with the conversation as staff now see it. */
 export const ConversationShowResponseSchema = z.strictObject({
     ok: z.literal(true),
-    data: z.strictObject({ conversation: ConversationDetailSchema }),
+    data: z.strictObject({ conversation: ConversationShowSchema }),
+});
+/** Review status needs `records:status`, a note `records:note`; at least one is required. */
+export const ConversationReviewRequestSchema = z
+    .strictObject({
+    reviewStatus: ConversationReviewStatusSchema.optional(),
+    note: NoteTextSchema.optional(),
+})
+    .refine((value) => value.reviewStatus !== undefined || value.note !== undefined, {
+    message: 'Set a review status or add a note.',
 });
 export const ConversationExportResponseSchema = z.strictObject({
     ok: z.literal(true),
@@ -91,6 +118,7 @@ const ClientItemSchema = z.discriminatedUnion('kind', [
 ]);
 const ClientDetailSchema = z.object({
     ...ClientSummarySchema.shape,
+    expiresAt: ConversationDetailSchema.shape.expiresAt,
     items: z.array(ClientItemSchema).max(10_000),
 });
 export const ConversationListClientResponseSchema = z.object({
@@ -102,7 +130,12 @@ export const ConversationListClientResponseSchema = z.object({
 });
 export const ConversationShowClientResponseSchema = z.object({
     ok: z.literal(true),
-    data: z.object({ conversation: ClientDetailSchema }),
+    data: z.object({
+        conversation: z.object({
+            ...ClientDetailSchema.shape,
+            notes: z.array(z.object(ConversationNoteSchema.shape)).max(100),
+        }),
+    }),
 });
 export const ConversationExportClientResponseSchema = z.object({
     ok: z.literal(true),
@@ -117,4 +150,43 @@ export const ConversationForgetClientResponseSchema = z.object({
         forgotten: z.object(ConversationForgetResponseSchema.shape.data.shape.forgotten.shape),
     }),
 });
+/**
+ * The customer-backend projection (ADR 0241 decision 12): an embed client lists or forgets one of its
+ * own verified users, by the same `user.id` its session exchange sent. The tenant comes from the client
+ * credential, never the body; rows carry no subject and at most a short preview of the first question.
+ */
+const CustomerUserSchema = z.strictObject({ id: z.string().min(1).max(240) });
+export const ASSISTANT_CONVERSATION_PAGE_MAXIMUM = 50;
+export const ASSISTANT_CONVERSATION_PREVIEW_MAXIMUM = 120;
+export const AssistantConversationListRequestSchema = z.strictObject({
+    user: CustomerUserSchema,
+    limit: z.number().int().min(1).max(ASSISTANT_CONVERSATION_PAGE_MAXIMUM).optional(),
+    cursor: NextCursorSchema.optional(),
+});
+export const AssistantConversationForgetUserRequestSchema = z.strictObject({
+    user: CustomerUserSchema,
+});
+const AssistantConversationRowSchema = z.strictObject({
+    id: ConversationIdSchema,
+    channel: ConversationChannelSchema,
+    startedAt: z.iso.datetime(),
+    lastMessageAt: z.iso.datetime(),
+    preview: z.string().min(1).max(ASSISTANT_CONVERSATION_PREVIEW_MAXIMUM).optional(),
+});
+export const AssistantConversationListResponseSchema = z.strictObject({
+    ok: z.literal(true),
+    data: z.strictObject({
+        conversations: z.array(AssistantConversationRowSchema).max(ASSISTANT_CONVERSATION_PAGE_MAXIMUM),
+        nextCursor: NextCursorSchema.optional(),
+    }),
+});
+export const AssistantConversationListClientResponseSchema = z.object({
+    ok: z.literal(true),
+    data: z.object({
+        conversations: z
+            .array(z.object(AssistantConversationRowSchema.shape))
+            .max(ASSISTANT_CONVERSATION_PAGE_MAXIMUM),
+        nextCursor: NextCursorSchema.optional(),
+    }),
+});
 //# sourceMappingURL=conversation-history.js.map

package/node_modules/@noodle-borg/wire-contracts/dist/index.d.ts

@@ -391,6 +391,7 @@ export * from './application-activity.js';
 export * from './application-connections.js';
 export * from './application-draft-validation.js';
 export * from './application-drafts.js';
+export * from './application-history-settings.js';
 export * from './application-onboarding.js';
 export * from './billing-catalog.js';
 export * from './business-workspaces.js';

package/node_modules/@noodle-borg/wire-contracts/dist/index.js

@@ -230,6 +230,7 @@ export * from './application-activity.js';
 export * from './application-connections.js';
 export * from './application-draft-validation.js';
 export * from './application-drafts.js';
+export * from './application-history-settings.js';
 export * from './application-onboarding.js';
 export * from './billing-catalog.js';
 export * from './business-workspaces.js';

package/node_modules/@noodleseed/assistant/README.md

@@ -626,6 +626,25 @@ replay across sessions. React applications may observe recovery and structured f
 `createAssistantSession` returns the opaque token, expiry, resolved non-secret configuration, and explicit
 turn/interaction endpoint URLs. Forward that response unchanged to the component or headless client.
 
+#### Your users' conversation history
+
+When the business records conversations, the same backend credential lists or erases one signed-in user's
+chats. Pass the exact `user.id` your session exchange sends; the client's application environment is the
+only scope, so one customer's backend never reaches another's history.
+
+```ts
+import { forgetUser, listConversations } from "@noodleseed/assistant/server";
+
+const credentials = { serviceUrl, clientId, clientSecret };
+// A "your chats" view: newest first, each with a short preview of the first question.
+const page = await listConversations({ ...credentials, user: { id: account.id }, limit: 20 });
+// In your own account deletion. Idempotent, so a retry after a 5xx is safe.
+await forgetUser({ ...credentials, user: { id: account.id } });
+```
+
+`forgetUser` erases stored conversation history only; a live session's short-lived working memory is not
+touched and expires within two hours. Failures throw `AssistantConversationsError` with a typed `detail` (`status`, `retryable`, `serviceCode`).
+
 The MCP server's top-level `branding` block is the portable deployment source for identity and colors shared
 by widgets and the assistant. The embedding application may use the typed `appearance` object when it needs
 exact control over assistant-specific roles:

package/node_modules/@noodleseed/assistant/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noodleseed/assistant",
-  "version": "1.36.1",
+  "version": "1.37.0",
   "description": "Embed the Noodle Seed customer-branded assistant in your web app with managed or framework-owned UI, a framework-neutral MCP App host, a DOM-free client, and a backend session helper. Authoring and deploying the server is @noodleseed/one.",
   "license": "Apache-2.0",
   "repository": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noodleseed/one",
-  "version": "0.177.0",
+  "version": "0.178.0",
   "private": false,
   "description": "Noodle CLI by Noodle Seed — author, run, and deploy declarative MCP servers. Embedding the assistant in your own web app is @noodleseed/assistant.",
   "license": "Apache-2.0",
@@ -236,7 +236,7 @@
     "@modelcontextprotocol/client": "2.0.0",
     "@modelcontextprotocol/server": "2.0.0",
     "@noodle-borg/admission-limits": "0.0.0",
-    "@noodle-borg/agent-kit": "0.107.0",
+    "@noodle-borg/agent-kit": "0.108.0",
     "@noodle-borg/app-audit": "0.0.0",
     "@noodle-borg/app-package": "0.0.0",
     "@noodle-borg/assistant-gateway": "0.0.0",