@m6d/cortex-cli 1.9.0 → 1.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@m6d/cortex-cli",
-    "version": "1.9.0",
+    "version": "1.10.0",
     "description": "Scaffold and operate Cortex servers",
     "license": "MIT",
     "type": "module",

package/src/contracts/runtime/index.ts

@@ -48,6 +48,29 @@ export const JSON_SCHEMA_ISSUE_KINDS = ["missing", "unexpected", "type_mismatch"
 
 export const agentSlugSchema = z.string().regex(AGENT_SLUG_PATTERN);
 export const localeSchema = z.enum(["en", "ar"]);
+
+/**
+ * The widget's landing-page prompt chips, per locale. Every source of them
+ * (the Control Center agent row, a server-code override, the capabilities
+ * handshake) stores this exact shape, so the widget never sees a blank or
+ * unbounded chip whichever source won. Pure validation, no transforms: a
+ * value that passes is served verbatim, so each source trims before it
+ * stores.
+ */
+export const SUGGESTION_LIMITS = { perLocale: 6, chipLength: 200 } as const;
+export const suggestionsSchema = z.record(
+    localeSchema,
+    z
+        .array(
+            z
+                .string()
+                .min(1)
+                .max(SUGGESTION_LIMITS.chipLength)
+                .refine((chip) => chip === chip.trim(), "chip has surrounding whitespace"),
+        )
+        .max(SUGGESTION_LIMITS.perLocale),
+);
+export type Suggestions = z.infer<typeof suggestionsSchema>;
 export const catalogVersionSchema = z.string().regex(/^[0-9a-f]{16}$/);
 
 export const sharedShapeSchema = z.object({
@@ -370,6 +393,8 @@ export const runtimeAgentConfigSchema = z.object({
     triggers: z.array(triggerDeclarationSchema).default([]),
     /** Whether end users may message this agent; false makes it headless. */
     messageTrigger: z.boolean().default(true),
+    /** Operational like `messageTrigger`: edited on the agent row without republishing. */
+    suggestions: suggestionsSchema,
     /** Absent from older Control Centers; reports then carry only the slug. */
     agentRef: agentRefSchema.optional(),
     catalogVersion: catalogVersionSchema,

package/src/contracts/wire/index.ts

@@ -99,6 +99,8 @@ export type AgentCapabilities = {
     attachments: boolean;
     /** False when the agent's `message` trigger is off: the widget hides its composer. */
     messages: boolean;
+    /** Prompt chips on the blank-chat landing per locale, the runtime contract's `suggestionsSchema` shape; clicking one sends it as the first message. */
+    suggestions: Record<"en" | "ar", string[]>;
 };
 
 export type MessageMetadata = {