@rubytech/create-maxy 1.0.506 → 1.0.508

package/payload/premium-plugins/real-agency/plugins/real-agency-loop/mcp/src/tools/team-availability.ts

@@ -4,7 +4,12 @@ import {
   loopGet,
 } from "../lib/loop-api.js";
 
+// ─── Loop API V2: /team/{agentId}/availability/{searchDate} ────
+// Returns array of: { agentId, start, end }
+// Times are ISO datetime strings (e.g. "2026-04-10T06:00:00")
+// ────────────────────────────────────────────────────────────────
 interface LoopTimeRange {
+  agentId?: string;
   start?: string;
   end?: string;
   [key: string]: unknown;
@@ -33,10 +38,15 @@ export async function teamAvailability(params: {
   return formatAggregationResult(
     result,
     (slot) => {
-      const start = slot.start ?? "?";
-      const end = slot.end ?? "?";
+      const start = slot.start ? formatTime(slot.start) : "?";
+      const end = slot.end ? formatTime(slot.end) : "?";
       return `- ${start} — ${end}`;
     },
     `availability slots for ${searchDate}`
   );
 }
+
+function formatTime(iso: string): string {
+  const timePart = iso.split("T")[1];
+  return timePart ? timePart.slice(0, 5) : iso;
+}

package/payload/premium-plugins/real-agency/plugins/real-agency-loop/mcp/src/tools/team-info.ts

@@ -4,13 +4,39 @@ import {
   loopGet,
 } from "../lib/loop-api.js";
 
+// ─── Loop API V2: /team ────────────────────────────────────────
+// Fields: apiKey (redacted), clientName, teamName,
+//   address1, address2, address3, email, phoneNumber, websiteUrl,
+//   primaryDarkColour, primaryLightColour, secondaryDarkColour,
+//   secondaryLightColour, legalName, websiteContactUrl,
+//   websitePropertiesUrl, dateCreated,
+//   members[] (each: id, firstName, lastName, email, mobilePhone,
+//     jobTitle, signatureImageUrl, avatarImage, avatarMedium,
+//     avatarThumbnail, biography, customUrl, twitterUrl)
+// ────────────────────────────────────────────────────────────────
 interface LoopTeam {
-  id?: string;
-  name?: string;
-  address?: string;
-  phone?: string;
+  clientName?: string;
+  teamName?: string;
+  address1?: string;
+  address2?: string;
+  address3?: string;
+  email?: string;
+  phoneNumber?: string;
+  websiteUrl?: string;
+  legalName?: string;
+  dateCreated?: string;
+  members?: LoopTeamMember[];
+  [key: string]: unknown;
+}
+
+interface LoopTeamMember {
+  id: string;
+  firstName?: string;
+  lastName?: string;
   email?: string;
-  agentId?: string;
+  mobilePhone?: string;
+  jobTitle?: string;
+  biography?: string;
   [key: string]: unknown;
 }
 
@@ -43,11 +69,26 @@ export async function teamInfo(params: {
   return formatAggregationResult(
     result,
     (t) => {
-      const name = t.name ?? "Unknown";
-      const addr = t.address ? ` — ${t.address}` : "";
-      const phone = t.phone ? ` | ${t.phone}` : "";
+      const name = t.teamName ?? t.clientName ?? "Unknown";
+      const client = t.clientName && t.clientName !== t.teamName ? ` (${t.clientName})` : "";
+      const addr = t.address1 ? ` — ${t.address1}` : "";
+      const phone = t.phoneNumber ? ` | ${t.phoneNumber}` : "";
       const email = t.email ? ` | ${t.email}` : "";
-      return `- **${name}**${addr}${phone}${email}`;
+      const web = t.websiteUrl ? ` | ${t.websiteUrl}` : "";
+
+      const lines = [`- **${name}**${client}${addr}${phone}${email}${web}`];
+
+      if (t.members?.length) {
+        lines.push(`  Team members (${t.members.length}):`);
+        for (const m of t.members) {
+          const mName = [m.firstName, m.lastName].filter(Boolean).join(" ");
+          const title = m.jobTitle ? ` (${m.jobTitle})` : "";
+          const mEmail = m.email ? ` — ${m.email}` : "";
+          lines.push(`    - ${mName} [ID: ${m.id}]${title}${mEmail}`);
+        }
+      }
+
+      return lines.join("\n");
     },
     "teams"
   );

package/payload/premium-plugins/real-agency/plugins/real-agency-loop/mcp/src/tools/viewing-create.ts

@@ -2,6 +2,11 @@ import { loopPost, withTeamKey } from "../lib/loop-api.js";
 
 type Department = "sales" | "lettings";
 
+// ─── Loop API V2: POST /residential/{dept}/viewings ────────────
+// Request body: { propertyId, date, time, attendeeName,
+//   attendeeEmail?, attendeePhone? }
+// Response: number (the created viewing ID) in data field
+// ────────────────────────────────────────────────────────────────
 interface LoopNumberResponse {
   result?: number;
   [key: string]: unknown;

package/payload/premium-plugins/real-agency/plugins/real-agency-loop/mcp/src/tools/viewing-detail.ts

@@ -4,21 +4,73 @@ import {
   loopGet,
 } from "../lib/loop-api.js";
 
+// ─── Loop API V2: /residential/{dept}/viewings/{id} ────────────
+// Fields: id, dateCreated, dateOfAppointment, dateOfAppointmentEnd,
+//   dateBuyerFeedbackGiven, dateSellerFeedbackGiven, dateDone,
+//   status, type, comment, buyerFeedback, sellerFeedback,
+//   buyerConfirmed, sellerConfirmed, agentConfirmed,
+//   property (nested PropertySummary), buyer (nested BuyerSummary),
+//   seller (nested SellerSummary),
+//   attendingAgent (nested TeamMember), creatingAgent (nested TeamMember),
+//   teamId
+// ────────────────────────────────────────────────────────────────
 interface LoopViewingDetail {
-  id?: number;
-  propertyAddress?: string;
-  date?: string;
-  time?: string;
+  id: number;
+  dateCreated?: string;
+  dateOfAppointment?: string;
+  dateOfAppointmentEnd?: string;
+  dateBuyerFeedbackGiven?: string | null;
+  dateSellerFeedbackGiven?: string | null;
+  dateDone?: string | null;
   status?: string;
   type?: string;
-  attendeeName?: string;
-  attendeeEmail?: string;
-  attendeePhone?: string;
-  notes?: string;
-  buyerFeedback?: string;
-  sellerFeedback?: string;
-  renterFeedback?: string;
-  landlordFeedback?: string;
+  comment?: string | null;
+  buyerFeedback?: string | null;
+  sellerFeedback?: string | null;
+  buyerConfirmed?: boolean;
+  sellerConfirmed?: boolean;
+  agentConfirmed?: boolean;
+  property?: {
+    id: number;
+    propertyAddress?: string;
+    status?: string;
+    propertyType?: string;
+    price?: number;
+    bedrooms?: number;
+    [key: string]: unknown;
+  };
+  buyer?: {
+    id: number;
+    buyerGroupName?: string;
+    maxPrice?: number | null;
+    position?: string;
+    viewingCount?: number;
+    offerCount?: number;
+    [key: string]: unknown;
+  };
+  seller?: {
+    id: number;
+    sellerGroupName?: string;
+    propertyAddress?: string;
+    price?: number;
+    [key: string]: unknown;
+  };
+  attendingAgent?: {
+    id: string;
+    firstName?: string;
+    lastName?: string;
+    email?: string;
+    mobilePhone?: string;
+    jobTitle?: string;
+    [key: string]: unknown;
+  };
+  creatingAgent?: {
+    id: string;
+    firstName?: string;
+    lastName?: string;
+    [key: string]: unknown;
+  };
+  teamId?: string;
   [key: string]: unknown;
 }
 
@@ -50,21 +102,70 @@ export async function viewingDetail(params: {
   return formatAggregationResult(
     result,
     (v) => {
-      const lines = [`**${v.propertyAddress ?? "Unknown property"}**`];
-      const when = [v.date, v.time].filter(Boolean).join(" ");
-      if (when) lines.push(`Date/Time: ${when}`);
+      const propAddr = v.property?.propertyAddress ?? "Unknown property";
+      const lines = [`**${propAddr}** [Viewing ID: ${v.id}]`];
+
+      // Appointment time
+      if (v.dateOfAppointment) {
+        const start = formatDateTime(v.dateOfAppointment);
+        const end = v.dateOfAppointmentEnd ? formatDateTime(v.dateOfAppointmentEnd) : "";
+        lines.push(`Date/Time: ${start}${end ? ` — ${end}` : ""}`);
+      }
       if (v.status) lines.push(`Status: ${v.status}`);
       if (v.type) lines.push(`Type: ${v.type}`);
-      if (v.attendeeName) lines.push(`Attendee: ${v.attendeeName}`);
-      if (v.attendeeEmail) lines.push(`Email: ${v.attendeeEmail}`);
-      if (v.attendeePhone) lines.push(`Phone: ${v.attendeePhone}`);
-      if (v.notes) lines.push(`Notes: ${v.notes}`);
-      if (v.buyerFeedback) lines.push(`Buyer Feedback: ${v.buyerFeedback}`);
-      if (v.sellerFeedback) lines.push(`Seller Feedback: ${v.sellerFeedback}`);
-      if (v.renterFeedback) lines.push(`Renter Feedback: ${v.renterFeedback}`);
-      if (v.landlordFeedback) lines.push(`Landlord Feedback: ${v.landlordFeedback}`);
+
+      // Confirmation status
+      const confirmParts: string[] = [];
+      if (v.buyerConfirmed != null) confirmParts.push(`Buyer: ${v.buyerConfirmed ? "yes" : "no"}`);
+      if (v.sellerConfirmed != null) confirmParts.push(`Seller: ${v.sellerConfirmed ? "yes" : "no"}`);
+      if (v.agentConfirmed != null) confirmParts.push(`Agent: ${v.agentConfirmed ? "yes" : "no"}`);
+      if (confirmParts.length) lines.push(`Confirmed — ${confirmParts.join(", ")}`);
+
+      // Property details
+      if (v.property) {
+        const prop = v.property;
+        if (prop.price != null) lines.push(`Property price: £${prop.price.toLocaleString("en-GB")}`);
+        if (prop.propertyType) lines.push(`Property type: ${prop.propertyType}`);
+        if (prop.bedrooms != null) lines.push(`Bedrooms: ${prop.bedrooms}`);
+        if (prop.id) lines.push(`Property ID: ${prop.id}`);
+      }
+
+      // Buyer
+      if (v.buyer) {
+        const b = v.buyer;
+        lines.push(`\n**Buyer:** ${b.buyerGroupName ?? "Unknown"} [ID: ${b.id}]`);
+        if (b.maxPrice != null) lines.push(`  Max price: £${b.maxPrice.toLocaleString("en-GB")}`);
+        if (b.position && b.position !== "none") lines.push(`  Position: ${b.position}`);
+      }
+
+      // Seller
+      if (v.seller) {
+        const s = v.seller;
+        lines.push(`\n**Seller:** ${s.sellerGroupName ?? "Unknown"} [ID: ${s.id}]`);
+      }
+
+      // Attending agent
+      if (v.attendingAgent) {
+        const a = v.attendingAgent;
+        const agentName = [a.firstName, a.lastName].filter(Boolean).join(" ");
+        const title = a.jobTitle ? ` (${a.jobTitle})` : "";
+        const contact = a.email ?? a.mobilePhone ?? "";
+        lines.push(`\n**Attending agent:** ${agentName}${title}${contact ? ` — ${contact}` : ""}`);
+      }
+
+      // Feedback
+      if (v.buyerFeedback) lines.push(`\nBuyer feedback: ${v.buyerFeedback}`);
+      if (v.sellerFeedback) lines.push(`Seller feedback: ${v.sellerFeedback}`);
+      if (v.comment) lines.push(`Notes: ${v.comment}`);
+
       return lines.join("\n");
     },
     "viewing details"
   );
 }
+
+function formatDateTime(iso: string): string {
+  const [datePart, timePart] = iso.split("T");
+  if (!timePart) return datePart;
+  return `${datePart} ${timePart.slice(0, 5)}`;
+}

package/payload/premium-plugins/real-agency/plugins/real-agency-loop/mcp/src/tools/viewing-search.ts

@@ -4,14 +4,22 @@ import {
   loopGet,
 } from "../lib/loop-api.js";
 
+// ─── Loop API V2: /residential/{dept}/viewings ─────────────────
+// Fields: id, propertyId, propertyAddress, status,
+//   dateOfAppointment, dateOfAppointmentEnd,
+//   attendingAgentId, creatingAgentId, type, buyerName
+// ────────────────────────────────────────────────────────────────
 interface LoopViewingSummary {
-  id?: number;
+  id: number;
+  propertyId?: number;
   propertyAddress?: string;
-  date?: string;
-  time?: string;
   status?: string;
+  dateOfAppointment?: string;
+  dateOfAppointmentEnd?: string;
+  attendingAgentId?: string;
+  creatingAgentId?: string;
   type?: string;
-  attendeeName?: string;
+  buyerName?: string;
   [key: string]: unknown;
 }
 
@@ -63,12 +71,22 @@ export async function viewingSearch(params: {
     result,
     (v) => {
       const addr = v.propertyAddress ?? "Unknown property";
-      const when = [v.date, v.time].filter(Boolean).join(" ");
+      const id = v.id != null ? ` [ID: ${v.id}]` : "";
+      // dateOfAppointment is ISO datetime e.g. "2026-04-10T15:30:00"
+      const when = v.dateOfAppointment
+        ? formatDateTime(v.dateOfAppointment)
+        : "No date";
       const viewStatus = v.status ? ` [${v.status}]` : "";
-      const attendee = v.attendeeName ? ` — ${v.attendeeName}` : "";
+      const buyer = v.buyerName ? ` — ${v.buyerName}` : "";
       const viewType = v.type ? ` (${v.type})` : "";
-      return `- ${addr} — ${when || "No date"}${viewType}${attendee}${viewStatus}`;
+      return `- ${addr}${id} — ${when}${viewType}${buyer}${viewStatus}`;
     },
     "viewings"
   );
 }
+
+function formatDateTime(iso: string): string {
+  const [datePart, timePart] = iso.split("T");
+  if (!timePart) return datePart;
+  return `${datePart} ${timePart.slice(0, 5)}`;
+}

package/payload/premium-plugins/real-agency/plugins/real-agency-loop/mcp/src/tools/viewing-update.ts

@@ -8,6 +8,11 @@ type Department = "sales" | "lettings";
 type FeedbackParty = "buyer" | "seller" | "renter" | "landlord";
 type Action = "note" | "feedback";
 
+// ─── Loop API V2: POST /residential/{dept}/viewings/{id}/{suffix}
+// Suffix: "note" for notes, "{party}-feedback" for feedback
+// Request body: { result: string } (StringResponse format)
+// Response: boolean success
+// ────────────────────────────────────────────────────────────────
 interface LoopBooleanResponse {
   success?: boolean;
   [key: string]: unknown;

package/payload/server/server.js

@@ -3700,9 +3700,9 @@ async function getRecentMessages(conversationId, limit = 50) {
   try {
     const result = await session.run(
       `MATCH (m:Message {conversationId: $conversationId})
+       WITH m ORDER BY m.createdAt DESC LIMIT $limit
        RETURN m.messageId AS messageId, m.role AS role, m.content AS content, m.createdAt AS createdAt
-       ORDER BY m.createdAt ASC
-       LIMIT $limit`,
+       ORDER BY m.createdAt ASC`,
       { conversationId, limit: neo4j.int(limit) }
     );
     return result.records.map((r) => ({
@@ -3971,6 +3971,26 @@ async function autoLabelSession(conversationId, userMessage) {
     if (currentEntry) currentEntry.pending = false;
   }
 }
+async function renameConversation(conversationId, label) {
+  let embedding = null;
+  try {
+    embedding = await embed(label);
+  } catch (err) {
+    console.error(`[persist] manual-label: embedding failed, persisting without: ${err instanceof Error ? err.message : String(err)}`);
+  }
+  const session = getSession();
+  try {
+    await session.run(
+      `MATCH (c:Conversation {conversationId: $conversationId})
+       SET c.name = $label, c.updatedAt = datetime()
+       ${embedding ? ", c.embedding = $embedding" : ""}`,
+      { conversationId, label, ...embedding ? { embedding } : {} }
+    );
+    console.error(`[persist] manual-label: renamed ${conversationId} to "${label}"${embedding ? " (embedded)" : ""}`);
+  } finally {
+    await session.close();
+  }
+}
 var INITIAL_CONFIDENCE = 0.5;
 var REINFORCEMENT_INCREMENT = 0.15;
 var DECAY_THRESHOLD_DAYS = 14;
@@ -5395,41 +5415,42 @@ function consumeStalledSubagents(sessionKey) {
   return stalls && stalls.length > 0 ? stalls : void 0;
 }
 function getMcpServers(accountId, userId, enabledPlugins) {
+  const LOG_DIR2 = resolve5(ACCOUNTS_DIR, accountId, "logs");
   const servers = {
     "memory": {
       command: "node",
       args: [resolve5(PLATFORM_ROOT4, "plugins/memory/mcp/dist/index.js")],
-      env: { ACCOUNT_ID: accountId, PLATFORM_ROOT: PLATFORM_ROOT4, ...userId ? { USER_ID: userId } : {} }
+      env: { ACCOUNT_ID: accountId, PLATFORM_ROOT: PLATFORM_ROOT4, LOG_DIR: LOG_DIR2, ...userId ? { USER_ID: userId } : {} }
     },
     "contacts": {
       command: "node",
       args: [resolve5(PLATFORM_ROOT4, "plugins/contacts/mcp/dist/index.js")],
-      env: { ACCOUNT_ID: accountId, PLATFORM_ROOT: PLATFORM_ROOT4 }
+      env: { ACCOUNT_ID: accountId, PLATFORM_ROOT: PLATFORM_ROOT4, LOG_DIR: LOG_DIR2 }
     },
     "whatsapp": {
       command: "node",
       args: [resolve5(PLATFORM_ROOT4, "plugins/whatsapp/mcp/dist/index.js")],
-      env: { ACCOUNT_ID: accountId, PLATFORM_ROOT: PLATFORM_ROOT4, PLATFORM_PORT: process.env.PORT ?? "19200" }
+      env: { ACCOUNT_ID: accountId, PLATFORM_ROOT: PLATFORM_ROOT4, LOG_DIR: LOG_DIR2, PLATFORM_PORT: process.env.PORT ?? "19200" }
     },
     "admin": {
       command: "node",
       args: [resolve5(PLATFORM_ROOT4, "plugins/admin/mcp/dist/index.js")],
-      env: { ACCOUNT_ID: accountId, PLATFORM_ROOT: PLATFORM_ROOT4, PLATFORM_PORT: process.env.PORT ?? "19200", ...userId ? { USER_ID: userId } : {} }
+      env: { ACCOUNT_ID: accountId, PLATFORM_ROOT: PLATFORM_ROOT4, LOG_DIR: LOG_DIR2, PLATFORM_PORT: process.env.PORT ?? "19200", ...userId ? { USER_ID: userId } : {} }
     },
     "scheduling": {
       command: "node",
       args: [resolve5(PLATFORM_ROOT4, "plugins/scheduling/mcp/dist/index.js")],
-      env: { ACCOUNT_ID: accountId, PLATFORM_ROOT: PLATFORM_ROOT4 }
+      env: { ACCOUNT_ID: accountId, PLATFORM_ROOT: PLATFORM_ROOT4, LOG_DIR: LOG_DIR2 }
     },
     "tasks": {
       command: "node",
       args: [resolve5(PLATFORM_ROOT4, "plugins/tasks/mcp/dist/index.js")],
-      env: { ACCOUNT_ID: accountId, PLATFORM_ROOT: PLATFORM_ROOT4 }
+      env: { ACCOUNT_ID: accountId, PLATFORM_ROOT: PLATFORM_ROOT4, LOG_DIR: LOG_DIR2 }
     },
     "email": {
       command: "node",
       args: [resolve5(PLATFORM_ROOT4, "plugins/email/mcp/dist/index.js")],
-      env: { ACCOUNT_ID: accountId, PLATFORM_ROOT: PLATFORM_ROOT4 }
+      env: { ACCOUNT_ID: accountId, PLATFORM_ROOT: PLATFORM_ROOT4, LOG_DIR: LOG_DIR2 }
     },
     // Playwright MCP server — browser automation for browser-specialist.
     // Key matches Claude Code's plugin naming: plugin_{plugin}_{server} so tools
@@ -5446,7 +5467,7 @@ function getMcpServers(accountId, userId, enabledPlugins) {
     servers["telegram"] = {
       command: "node",
       args: [resolve5(PLATFORM_ROOT4, "plugins/telegram/mcp/dist/index.js")],
-      env: { ACCOUNT_ID: accountId, PLATFORM_ROOT: PLATFORM_ROOT4 }
+      env: { ACCOUNT_ID: accountId, PLATFORM_ROOT: PLATFORM_ROOT4, LOG_DIR: LOG_DIR2 }
     };
   } else {
     console.error("[plugins] telegram MCP: skipped (no TELEGRAM_PUBLIC_BOT_TOKEN)");
@@ -5454,7 +5475,7 @@ function getMcpServers(accountId, userId, enabledPlugins) {
   servers["cloudflare"] = {
     command: "node",
     args: [resolve5(PLATFORM_ROOT4, "plugins/cloudflare/mcp/dist/index.js")],
-    env: { PLATFORM_ROOT: PLATFORM_ROOT4, PLATFORM_PORT: process.env.PORT ?? "19200" }
+    env: { ACCOUNT_ID: accountId, PLATFORM_ROOT: PLATFORM_ROOT4, LOG_DIR: LOG_DIR2, PLATFORM_PORT: process.env.PORT ?? "19200" }
   };
   if (Array.isArray(enabledPlugins) && enabledPlugins.length > 0) {
     const pluginsDir = resolve5(PLATFORM_ROOT4, "plugins");
@@ -5485,7 +5506,7 @@ function getMcpServers(accountId, userId, enabledPlugins) {
       servers[dir] = {
         command: "node",
         args: [mcpEntry],
-        env: { ACCOUNT_ID: accountId, PLATFORM_ROOT: PLATFORM_ROOT4 }
+        env: { ACCOUNT_ID: accountId, PLATFORM_ROOT: PLATFORM_ROOT4, LOG_DIR: LOG_DIR2 }
       };
       console.log(`[plugins] optional MCP server started: ${dir}`);
     }
@@ -27210,8 +27231,87 @@ async function GET11(req, { params }) {
   }
 }
 
+// app/api/admin/sessions/[id]/label/route.ts
+var LABEL_MAX_LENGTH = 200;
+async function POST23(req, { params }) {
+  const { id: conversationId } = await params;
+  const url2 = new URL(req.url);
+  const sessionKey = url2.searchParams.get("session_key");
+  if (!sessionKey) {
+    return Response.json({ error: "session_key required" }, { status: 400 });
+  }
+  if (!validateSession(sessionKey, "admin")) {
+    return Response.json({ error: "Invalid or expired admin session" }, { status: 401 });
+  }
+  const accountId = getAccountIdForSession(sessionKey);
+  if (!accountId) {
+    return Response.json({ error: "Account not found for session" }, { status: 401 });
+  }
+  const owned = await verifyConversationOwnership(conversationId, accountId);
+  if (!owned) {
+    return Response.json({ error: "Conversation not found" }, { status: 404 });
+  }
+  console.error(`[admin] manual-label: requesting suggestion for ${conversationId}`);
+  try {
+    const messages = await getRecentMessages(conversationId, 50);
+    const userMessages = messages.filter((m) => m.role === "user").map((m) => m.content);
+    if (userMessages.length === 0) {
+      console.error(`[admin] manual-label: haiku failed for ${conversationId} \u2014 no user messages`);
+      return Response.json({ label: null });
+    }
+    const label = await generateSessionLabel(userMessages);
+    if (label) {
+      console.error(`[admin] manual-label: haiku suggested "${label}" for ${conversationId}`);
+    } else {
+      console.error(`[admin] manual-label: haiku failed for ${conversationId} \u2014 null response`);
+    }
+    return Response.json({ label });
+  } catch (err) {
+    console.error(`[admin] manual-label: haiku failed for ${conversationId} \u2014 ${err instanceof Error ? err.message : String(err)}`);
+    return Response.json({ label: null });
+  }
+}
+async function PUT(req, { params }) {
+  const { id: conversationId } = await params;
+  let body;
+  try {
+    body = await req.json();
+  } catch {
+    return Response.json({ error: "Invalid JSON body" }, { status: 400 });
+  }
+  const sessionKey = body.session_key;
+  if (!sessionKey) {
+    return Response.json({ error: "session_key required" }, { status: 400 });
+  }
+  if (!validateSession(sessionKey, "admin")) {
+    return Response.json({ error: "Invalid or expired admin session" }, { status: 401 });
+  }
+  const accountId = getAccountIdForSession(sessionKey);
+  if (!accountId) {
+    return Response.json({ error: "Account not found for session" }, { status: 401 });
+  }
+  const owned = await verifyConversationOwnership(conversationId, accountId);
+  if (!owned) {
+    return Response.json({ error: "Conversation not found" }, { status: 404 });
+  }
+  const label = typeof body.label === "string" ? body.label.trim() : "";
+  if (!label) {
+    return Response.json({ error: "label is required and must be non-empty" }, { status: 400 });
+  }
+  if (label.length > LABEL_MAX_LENGTH) {
+    return Response.json({ error: `label must be ${LABEL_MAX_LENGTH} characters or fewer` }, { status: 400 });
+  }
+  try {
+    await renameConversation(conversationId, label);
+    return Response.json({ ok: true });
+  } catch (err) {
+    console.error(`[persist] manual-label: failed to rename ${conversationId} \u2014 ${err instanceof Error ? err.message : String(err)}`);
+    return Response.json({ error: "Failed to rename session" }, { status: 500 });
+  }
+}
+
 // app/api/admin/browser/launch/route.ts
-async function POST23() {
+async function POST24() {
   try {
     const vncOk = await ensureVnc();
     if (!vncOk) {
@@ -27609,7 +27709,7 @@ app.post("/api/admin/file-attach", (c) => POST16(c.req.raw));
 app.get("/api/admin/version", () => GET9());
 app.post("/api/admin/version/upgrade", (c) => POST22(c.req.raw));
 app.get("/api/admin/agents", () => GET8());
-app.post("/api/admin/browser/launch", () => POST23());
+app.post("/api/admin/browser/launch", () => POST24());
 app.get("/api/admin/sessions", (c) => GET10(c.req.raw));
 app.delete(
   "/api/admin/sessions/:id",
@@ -27619,6 +27719,14 @@ app.get(
   "/api/admin/sessions/:id/messages",
   (c) => GET11(c.req.raw, { params: Promise.resolve({ id: c.req.param("id") }) })
 );
+app.post(
+  "/api/admin/sessions/:id/label",
+  (c) => POST23(c.req.raw, { params: Promise.resolve({ id: c.req.param("id") }) })
+);
+app.put(
+  "/api/admin/sessions/:id/label",
+  (c) => PUT(c.req.raw, { params: Promise.resolve({ id: c.req.param("id") }) })
+);
 var SAFE_SLUG_RE = /^[a-z][a-z0-9-]{2,49}$/;
 var SAFE_FILENAME_RE = /^[a-z0-9_][a-z0-9_.-]{0,99}$/i;
 var IMAGE_MIME = {