@axiom-lattice/protocols 4.2.2 → 4.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axiom-lattice/protocols",
-  "version": "4.2.2",
+  "version": "4.3.0",
   "description": "Unified protocol type definitions for Axiom Lattice framework",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/AgentWebAppStoreProtocol.ts

@@ -21,11 +21,21 @@ export interface AgentWebAppFeatures {
   files?: boolean;
 }
 
+/** One quick-start suggestion offered in the Web App chat empty state. */
+export interface AgentWebAppQuickPrompt {
+  /** Button label, 1–40 chars. */
+  label: string;
+  /** Message text sent when the prompt is chosen, 1–500 chars. */
+  text: string;
+}
+
 /** Optional display customization for an Agent Web App. */
 export interface AgentWebAppAppearance {
   title?: string;
   welcomeMessage?: string;
   primaryColor?: string;
+  /** Up to 6 quick-start suggestions for the chat empty state. */
+  quickPrompts?: AgentWebAppQuickPrompt[];
 }
 
 /** Identity assurance levels reported by the runtime. */

package/src/ProjectRoomMessageStoreProtocol.ts

@@ -34,4 +34,14 @@ export interface ProjectRoomMessageStore {
     after: Date;
     excludeAuthorUserId?: string;
   }): Promise<number>;
+
+  /**
+   * Deletes one bounded batch of chat messages (`source: "user" | "agent"`) older than a horizon.
+   *
+   * @param input Exclusive upper time bound and maximum batch size (clamped by the store).
+   * @returns The number of deleted rows; callers loop until it returns fewer than the requested batch.
+   * @remarks Task/system/routine events are immutable room history and are never deleted. Deletes are
+   * idempotent and safe under concurrent maintenance runs.
+   */
+  deleteChatOlderThan(input: { before: Date; limit: number }): Promise<number>;
 }

package/src/WorkspaceStoreProtocol.ts

@@ -54,11 +54,24 @@ export interface WorkspaceStore {
  * Project kind classification
  *
  * Defaults to "business" for legacy rows and omitted input.
- * "public" is reserved for the automatically ensured workspace public room;
- * user-facing project create/update APIs reject it.
+ * "public" marks a project visible to every member of the workspace;
+ * user-facing project create/update APIs accept it, but the automatically
+ * ensured workspace public room (see WORKSPACE_PUBLIC_ROOM_PROJECT_PREFIX)
+ * is protected from rename/delete.
  */
 export type ProjectKind = "business" | "training" | "personal" | "public";
 
+/**
+ * Project id prefix for the automatically ensured workspace public room.
+ * Projects with this prefix are synthetic: they are pinned in CoSpace and
+ * excluded from the user-facing Projects list.
+ */
+export const WORKSPACE_PUBLIC_ROOM_PROJECT_PREFIX = "workspace_public_";
+
+export function isWorkspacePublicRoomProjectId(projectId: string): boolean {
+  return projectId.startsWith(WORKSPACE_PUBLIC_ROOM_PROJECT_PREFIX);
+}
+
 /**
  * Project type definition
  */

package/src/__tests__/agent-web-app-types.test.ts

@@ -4,6 +4,7 @@ import type {
   AgentWebAppError,
   AgentWebAppErrorCode,
   AgentWebAppFeatures,
+  AgentWebAppQuickPrompt,
   AgentWebAppRuntimeThread,
   AgentWebAppScope,
   AgentWebAppStore,
@@ -32,13 +33,15 @@ type CreateAgentWebAppInputKeys =
   | "integration"
   | "scope"
   | "features"
-  | "appearance";
+  | "appearance"
+  | "identity";
 type UpdateAgentWebAppInputKeys =
   | "name"
   | "description"
   | "scope"
   | "features"
-  | "appearance";
+  | "appearance"
+  | "identity";
 type AgentWebAppStorePatchKeys = UpdateAgentWebAppInputKeys | "status";
 
 type _CreateInputHasExactKeys = Expect<
@@ -83,8 +86,13 @@ type AgentWebAppBootstrapFeatureKeys =
   | "threadManagement"
   | "attachments"
   | "hitl"
-  | "genUI";
-type AgentWebAppBootstrapAppearanceKeys = "title" | "welcomeMessage" | "primaryColor";
+  | "genUI"
+  | "files";
+type AgentWebAppBootstrapAppearanceKeys =
+  | "title"
+  | "welcomeMessage"
+  | "primaryColor"
+  | "quickPrompts";
 
 type _BootstrapHasExactTopLevelKeys = Expect<
   Equal<keyof AgentWebAppBootstrap, AgentWebAppBootstrapKeys>
@@ -164,6 +172,11 @@ const features = {
   genUI: true,
 } satisfies CreateAgentWebAppInput["features"];
 
+const quickPrompt: AgentWebAppQuickPrompt = {
+  label: "Pricing",
+  text: "How much does it cost?",
+};
+
 const createInput = {
   assistantId: "assistant-1",
   name: "Customer portal",
@@ -176,7 +189,7 @@ const createInput = {
     allowedModelKeys: ["model-1", "model-2"],
   },
   features,
-  appearance: { title: "Support", primaryColor: "#123456" },
+  appearance: { title: "Support", primaryColor: "#123456", quickPrompts: [quickPrompt] },
 } satisfies CreateAgentWebAppInput;
 
 const webApp = {