clay-server 3.8.1 → 4.0.0-beta.10

package/lib/yoke/user-input.js

@@ -0,0 +1,254 @@
+// Provider-neutral structured user-input lifecycle for YOKE queries.
+
+var crypto = require("crypto");
+var z;
+try { z = require("zod"); } catch (e) { z = null; }
+
+var TOOL_NAME = "ask_user_questions";
+
+function cleanText(value, field, max) {
+  if (typeof value !== "string" || !value.trim()) throw new Error(field + " must be a non-empty string.");
+  var text = value.trim();
+  if (text.length > max) throw new Error(field + " must be at most " + max + " characters.");
+  return text;
+}
+
+function normalizeOptions(options, questionIndex) {
+  if (options == null) return [];
+  if (!Array.isArray(options)) throw new Error("Question " + (questionIndex + 1) + " options must be an array.");
+  if (options.length === 1 || options.length > 6) {
+    throw new Error("Question " + (questionIndex + 1) + " must use zero options or 2-6 options.");
+  }
+  var result = [];
+  for (var i = 0; i < options.length; i++) {
+    var option = options[i] || {};
+    result.push({
+      label: cleanText(option.label || option.value, "Option label", 60),
+      description: typeof option.description === "string" ? option.description.trim().substring(0, 160) : "",
+    });
+  }
+  return result;
+}
+
+function normalizeQuestions(input) {
+  var source = input && Array.isArray(input.questions) ? input.questions : null;
+  if (!source || source.length < 1 || source.length > 3) throw new Error("Structured input requires 1-3 questions.");
+  var ids = {};
+  var questions = [];
+  for (var i = 0; i < source.length; i++) {
+    var item = source[i] || {};
+    var id = typeof item.id === "string" && item.id.trim() ? item.id.trim() : "question_" + (i + 1);
+    if (id.length > 128 || ids[id]) throw new Error("Question IDs must be unique strings of at most 128 characters.");
+    ids[id] = true;
+    questions.push({
+      id: id,
+      header: typeof item.header === "string" ? item.header.trim().substring(0, 40) : "",
+      question: cleanText(item.question || item.prompt, "Question", 2000),
+      multiSelect: item.multiSelect === true,
+      allowOther: item.allowOther !== false && item.isOther !== false,
+      secret: item.secret === true || item.isSecret === true,
+      options: normalizeOptions(item.options, i),
+    });
+  }
+  return questions;
+}
+
+function questionsFromElicitation(request) {
+  var schema = request && request.requestedSchema;
+  var properties = schema && schema.properties && typeof schema.properties === "object" ? schema.properties : null;
+  var questions = [];
+  if (properties) {
+    Object.keys(properties).forEach(function (id) {
+      var property = properties[id] || {};
+      var values = Array.isArray(property.enum) ? property.enum : [];
+      questions.push({
+        id: id,
+        header: request.serverName || "Input",
+        question: property.description || request.message || id,
+        options: values.map(function (value) { return { label: String(value), description: "" }; }),
+      });
+    });
+  }
+  if (!questions.length) questions.push({ id: "response", header: request.serverName || "Input", question: request.message || "What should the tool use?", options: [] });
+  return { questions: questions };
+}
+
+function answerValues(value) {
+  if (value && Array.isArray(value.answers)) value = value.answers;
+  if (!Array.isArray(value)) value = value == null ? [] : [value];
+  return value.map(function (entry) { return String(entry).trim(); }).filter(Boolean);
+}
+
+function normalizeAnswers(questions, raw) {
+  raw = raw || {};
+  var answers = {};
+  for (var i = 0; i < questions.length; i++) {
+    var question = questions[i];
+    var value = Object.prototype.hasOwnProperty.call(raw, question.id) ? raw[question.id] : raw[i];
+    var values = answerValues(value);
+    if (!values.length) throw new Error("An answer is required for " + question.id + ".");
+    if (!question.multiSelect && values.length > 1) throw new Error("Only one answer is allowed for " + question.id + ".");
+    answers[question.id] = values;
+  }
+  return answers;
+}
+
+/**
+ * Start one provider-neutral structured-input request.
+ *
+ * handler receives:
+ *   request: { id, questions, source, native, provider, diagnostics }
+ *   respond(answers): submits once; respond.cancel(reason) cancels once.
+ *
+ * The returned promise resolves to { status, answers|reason }. Provider
+ * adapters translate that result back to their own wire protocol. Nothing in
+ * this lifecycle is persisted; Clay callers may persist sanitized events.
+ */
+function dispatchUserInput(handler, input, opts) {
+  opts = opts || {};
+  var questions;
+  try { questions = normalizeQuestions(input); } catch (e) { return Promise.reject(e); }
+  if (typeof handler !== "function") return Promise.reject(new Error("This query cannot request structured user input."));
+  var id = opts.requestId || (input && input.id) || "yoke_input_" + crypto.randomUUID();
+  var settled = false;
+  var abortHandler = null;
+  var settleListeners = [];
+  return new Promise(function (resolve, reject) {
+    function cleanup(result) {
+      if (opts.signal && abortHandler && typeof opts.signal.removeEventListener === "function") opts.signal.removeEventListener("abort", abortHandler);
+      for (var li = 0; li < settleListeners.length; li++) {
+        try { settleListeners[li](result); } catch (e) {}
+      }
+    }
+    function finish(result) {
+      if (settled) return false;
+      settled = true;
+      cleanup(result);
+      resolve(result);
+      return true;
+    }
+    function fail(error) {
+      if (settled) return false;
+      settled = true;
+      cleanup({ status: "error", error: error.message || String(error) });
+      reject(error);
+      return true;
+    }
+    var respond = function (answers) {
+      try { return finish({ status: "submitted", answers: normalizeAnswers(questions, answers) }); }
+      catch (e) { return fail(e); }
+    };
+    respond.submitContent = function (content) {
+      if (!content || typeof content !== "object" || Array.isArray(content)) return fail(new Error("Structured elicitation content must be an object."));
+      return finish({ status: "submitted", answers: {}, content: content });
+    };
+    respond.cancel = function (reason) { return finish({ status: "cancelled", reason: reason || "Cancelled" }); };
+    respond.isPending = function () { return !settled; };
+    respond.onSettle = function (listener) {
+      if (typeof listener === "function" && !settled) settleListeners.push(listener);
+      return respond;
+    };
+    abortHandler = function () { respond.cancel("Aborted"); };
+    if (opts.signal) {
+      if (opts.signal.aborted) return abortHandler();
+      opts.signal.addEventListener("abort", abortHandler, { once: true });
+    }
+    var request = {
+      id: String(id),
+      questions: questions,
+      presentation: opts.presentation || "questions",
+      source: opts.source || "unknown",
+      native: opts.native === true,
+      provider: opts.provider || null,
+      diagnostics: opts.diagnostics || null,
+    };
+    try {
+      var returned = handler(request, respond);
+      if (returned && typeof returned.then === "function") returned.catch(fail);
+    } catch (error) {
+      fail(error);
+    }
+  });
+}
+
+function claudePermissionResult(input, result) {
+  if (!result || result.status !== "submitted") return { behavior: "deny", message: (result && result.reason) || "Cancelled" };
+  var questions = normalizeQuestions(input);
+  var byText = {};
+  for (var i = 0; i < questions.length; i++) byText[questions[i].question] = result.answers[questions[i].id].join(", ");
+  return { behavior: "allow", updatedInput: Object.assign({}, input, { answers: byText }) };
+}
+
+function codexResponse(result) {
+  var answers = {};
+  if (result && result.status === "submitted") {
+    Object.keys(result.answers).forEach(function (id) { answers[id] = { answers: result.answers[id] }; });
+  }
+  return { answers: answers };
+}
+
+function elicitationResponse(result) {
+  if (!result || result.status !== "submitted") return { action: "reject" };
+  if (result.content) return { action: "accept", content: result.content };
+  var content = {};
+  Object.keys(result.answers).forEach(function (id) { content[id] = result.answers[id].length === 1 ? result.answers[id][0] : result.answers[id]; });
+  return { action: "accept", content: content };
+}
+
+function buildQuestionShape() {
+  if (!z) return {};
+  var option = z.object({ label: z.string().min(1).max(60), description: z.string().max(160).optional() }).passthrough();
+  var question = z.object({
+    id: z.string().max(128).optional(), header: z.string().max(40).optional(), question: z.string().min(1),
+    multiSelect: z.boolean().optional(), options: z.array(option).max(6).refine(function (items) { return items.length === 0 || items.length >= 2; }),
+  }).passthrough();
+  return { questions: z.array(question).min(1).max(3) };
+}
+
+function fallbackToolDefs(handler) {
+  return [{
+    name: TOOL_NAME,
+    description: "Ask the user 1-3 structured questions. Use zero options for freeform or 2-6 options for choices; never one option.",
+    inputSchema: buildQuestionShape(),
+    handler: function (input) {
+      return dispatchUserInput(handler, input, { source: "mcp_fallback", native: false }).then(function (result) {
+        if (result.status !== "submitted") return { content: [{ type: "text", text: "The user cancelled this question." }], isError: true };
+        return { content: [{ type: "text", text: JSON.stringify(result.answers) }] };
+      }).catch(function (error) { return { content: [{ type: "text", text: "Error: " + error.message }], isError: true }; });
+    },
+  }];
+}
+
+function capability(adapter) {
+  return adapter && adapter.userInputCapability ? adapter.userInputCapability : { mode: "fallback", native: false };
+}
+
+function selectMode(adapter, requestedMode) {
+  if (requestedMode === "fallback") return "fallback";
+  if (requestedMode === "native" && capability(adapter).mode !== "native") {
+    throw new Error("This provider does not support native structured user input.");
+  }
+  return capability(adapter).mode === "native" ? "native" : "fallback";
+}
+
+function createFallbackServer(adapter, handler) {
+  var opts = arguments.length > 2 && arguments[2] ? arguments[2] : {};
+  if (!adapter || typeof adapter.createToolServer !== "function") return null;
+  if (capability(adapter).mode === "native" && opts.force !== true) return null;
+  return adapter.createToolServer({ name: "yoke-user-input", version: "1.0.0", tools: fallbackToolDefs(handler) });
+}
+
+module.exports = {
+  TOOL_NAME: TOOL_NAME,
+  normalizeQuestions: normalizeQuestions,
+  questionsFromElicitation: questionsFromElicitation,
+  normalizeAnswers: normalizeAnswers,
+  dispatchUserInput: dispatchUserInput,
+  claudePermissionResult: claudePermissionResult,
+  codexResponse: codexResponse,
+  elicitationResponse: elicitationResponse,
+  fallbackToolDefs: fallbackToolDefs,
+  createFallbackServer: createFallbackServer,
+  capability: capability,
+  selectMode: selectMode,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clay-server",
-  "version": "3.8.1",
+  "version": "4.0.0-beta.10",
   "description": "Self-hosted team workspace for Claude Code and Codex. Multi-user, browser-based, with persistent AI mates.",
   "bin": {
     "clay-server": "./bin/cli.js",
@@ -49,9 +49,10 @@
   "homepage": "https://github.com/chadbyte/clay#readme",
   "author": "Chad",
   "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "^0.3.241",
+    "@anthropic-ai/claude-agent-sdk": "^0.3.258",
     "@lydell/node-pty": "^1.2.0-beta.3",
-    "@openai/codex": "^0.147.0",
+    "@openai/codex": "^0.152.1",
+    "@seald-io/nedb": "^4.1.2",
     "imapflow": "^1.3.1",
     "nodemailer": "^9.0.5",
     "qrcode-terminal": "^0.12.0",

package/lib/public/css/home-chat.css

@@ -1,380 +0,0 @@
-/* ==========================================================================
-   Clay FAB + popover — phablet-style chat reachable from anywhere
-   ==========================================================================
-   The FAB (#clay-fab) sits at the bottom-right corner over all page
-   content. Clicking it toggles #clay-popover, which contains the
-   .home-chat-frame (rounded card with header / messages / input).
-   Inspired by Vercel's persistent toolbar pattern. */
-
-/* --- FAB ---
-   Draggable. Default position is bottom-right; user position is
-   restored from localStorage. Inline `top`/`left` set by JS override
-   the default `right`/`bottom`. */
-
-.clay-fab {
-  position: fixed;
-  right: 18px;
-  bottom: 18px;
-  width: 44px;
-  height: 44px;
-  border-radius: 50%;
-  border: none;
-  background: var(--bg, #fff);
-  box-shadow: 0 4px 14px rgba(0, 0, 0, 0.16), 0 2px 4px rgba(0, 0, 0, 0.08);
-  cursor: grab;
-  z-index: 9000;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  padding: 0;
-  transition: box-shadow 0.18s, opacity 0.18s, transform 0.18s cubic-bezier(.2,.7,.3,1.3);
-  user-select: none;
-  touch-action: none;
-}
-.clay-fab:hover {
-  box-shadow: 0 8px 20px rgba(0, 0, 0, 0.2), 0 3px 6px rgba(0, 0, 0, 0.10);
-}
-.clay-fab.dragging {
-  cursor: grabbing;
-  transition: none;
-  box-shadow: 0 12px 28px rgba(0, 0, 0, 0.26), 0 4px 8px rgba(0, 0, 0, 0.14);
-}
-.clay-fab.open {
-  /* Hide while popover is open — the popover X button is the close path */
-  transform: scale(0.6);
-  opacity: 0;
-  pointer-events: none;
-}
-
-.clay-fab-icon {
-  width: 30px;
-  height: 30px;
-  border-radius: 50%;
-  object-fit: cover;
-  pointer-events: none;
-}
-
-/* Subtle pulse ring to draw the eye on first paint */
-.clay-fab-pulse {
-  position: absolute;
-  inset: -2px;
-  border-radius: 50%;
-  border: 2px solid var(--accent);
-  opacity: 0;
-  pointer-events: none;
-  animation: clay-fab-pulse 2.4s ease-out 1s 2;
-}
-@keyframes clay-fab-pulse {
-  0%   { opacity: 0;    transform: scale(1);   }
-  20%  { opacity: 0.55; }
-  100% { opacity: 0;    transform: scale(1.6); }
-}
-
-/* --- Popover --- */
-
-.clay-popover {
-  position: fixed;
-  right: 18px;
-  bottom: 18px;
-  width: 320px;
-  height: 480px;
-  max-width: calc(100vw - 32px);
-  max-height: calc(100vh - 40px);
-  z-index: 9001;
-  display: flex;
-  transform-origin: bottom right;
-  animation: clay-popover-in 0.18s cubic-bezier(.2,.7,.3,1.05);
-}
-.clay-popover.hidden {
-  display: none;
-}
-@keyframes clay-popover-in {
-  from { transform: translateY(8px) scale(0.96); opacity: 0; }
-  to   { transform: translateY(0)    scale(1);    opacity: 1; }
-}
-
-.clay-popover .home-chat-frame {
-  width: 100%;
-  height: 100%;
-  display: flex;
-  flex-direction: column;
-  background: var(--bg-alt, var(--bg));
-  border: 1px solid var(--border);
-  border-radius: 18px;
-  box-shadow: 0 14px 40px rgba(0, 0, 0, 0.22), 0 4px 10px rgba(0, 0, 0, 0.10);
-  overflow: hidden;
-}
-
-/* --- Header --- */
-
-.home-chat-header {
-  display: flex;
-  align-items: center;
-  gap: 10px;
-  padding: 12px 12px 12px 14px;
-  border-bottom: 1px solid var(--border);
-  background: var(--bg);
-}
-
-.home-chat-avatar-wrap {
-  width: 34px;
-  height: 34px;
-  border-radius: 50%;
-  overflow: hidden;
-  flex-shrink: 0;
-  background: var(--accent);
-  display: flex;
-  align-items: center;
-  justify-content: center;
-}
-
-.home-chat-avatar {
-  width: 100%;
-  height: 100%;
-  object-fit: cover;
-  display: block;
-}
-
-.home-chat-title-block {
-  flex: 1;
-  min-width: 0;
-}
-
-.home-chat-title {
-  font-size: 14px;
-  font-weight: 600;
-  color: var(--text);
-  line-height: 1.2;
-}
-
-.home-chat-subtitle {
-  font-size: 11px;
-  color: var(--text-muted, var(--text-dimmer));
-  line-height: 1.2;
-  margin-top: 2px;
-  white-space: nowrap;
-  overflow: hidden;
-  text-overflow: ellipsis;
-}
-
-.home-chat-icon-btn {
-  background: none;
-  border: none;
-  width: 30px;
-  height: 30px;
-  border-radius: 8px;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  cursor: pointer;
-  color: var(--text-muted, var(--text-dimmer));
-  flex-shrink: 0;
-}
-.home-chat-icon-btn:hover {
-  background: var(--hover-bg, rgba(0,0,0,0.05));
-  color: var(--text);
-}
-.home-chat-icon-btn .lucide {
-  width: 16px;
-  height: 16px;
-}
-
-/* --- Messages list --- */
-
-.home-chat-messages {
-  flex: 1;
-  overflow-y: auto;
-  padding: 14px 12px;
-  display: flex;
-  flex-direction: column;
-  gap: 8px;
-  background: var(--input-bg, var(--bg));
-  scroll-behavior: smooth;
-}
-
-.home-chat-bubble {
-  max-width: 88%;
-  padding: 9px 12px;
-  border-radius: 16px;
-  font-size: 13px;
-  line-height: 1.5;
-  word-wrap: break-word;
-  white-space: pre-wrap;
-  box-shadow: 0 1px 1px rgba(0,0,0,0.04);
-}
-
-.home-chat-bubble-user {
-  align-self: flex-end;
-  background: var(--accent);
-  color: #fff;
-  border-bottom-right-radius: 6px;
-}
-
-.home-chat-bubble-clay {
-  align-self: flex-start;
-  background: var(--bg);
-  color: var(--text);
-  border: 1px solid var(--border);
-  border-bottom-left-radius: 6px;
-}
-
-.home-chat-bubble-system {
-  align-self: center;
-  font-size: 11px;
-  color: var(--text-muted, var(--text-dimmer));
-  background: transparent;
-  padding: 4px 10px;
-  font-style: italic;
-  text-align: center;
-  max-width: 100%;
-}
-
-.home-chat-ref {
-  display: inline-block;
-  background: rgba(124, 58, 237, 0.08);
-  color: var(--accent);
-  padding: 1px 8px;
-  border-radius: 10px;
-  font-family: "Roboto Mono", "Courier New", monospace;
-  font-size: 11px;
-  cursor: pointer;
-  margin: 0 2px;
-  border: 1px solid rgba(124, 58, 237, 0.18);
-}
-.home-chat-ref:hover {
-  background: rgba(124, 58, 237, 0.16);
-}
-
-/* --- Typing indicator --- */
-
-.home-chat-typing {
-  display: flex;
-  gap: 4px;
-  padding: 4px 16px 0;
-  align-items: center;
-}
-.home-chat-typing.hidden { display: none; }
-
-.home-chat-typing-dot {
-  width: 5px;
-  height: 5px;
-  border-radius: 50%;
-  background: var(--text-dimmer);
-  animation: home-chat-bounce 1.2s infinite ease-in-out;
-}
-.home-chat-typing-dot:nth-child(1) { animation-delay: 0s; }
-.home-chat-typing-dot:nth-child(2) { animation-delay: 0.15s; }
-.home-chat-typing-dot:nth-child(3) { animation-delay: 0.30s; }
-
-@keyframes home-chat-bounce {
-  0%, 80%, 100% { transform: translateY(0);   opacity: 0.4; }
-  40%           { transform: translateY(-4px); opacity: 1;   }
-}
-
-/* --- Input row --- */
-
-.home-chat-input-row {
-  display: flex;
-  align-items: flex-end;
-  gap: 8px;
-  padding: 10px 10px 12px;
-  border-top: 1px solid var(--border);
-  background: var(--bg);
-}
-
-.home-chat-input {
-  flex: 1;
-  border: 1px solid var(--border);
-  border-radius: 16px;
-  padding: 9px 12px;
-  background: var(--input-bg, var(--bg));
-  color: var(--text);
-  font-size: 13px;
-  line-height: 1.5;
-  font-family: inherit;
-  resize: none;
-  max-height: 120px;
-  outline: none;
-  transition: border-color 0.15s, box-shadow 0.15s;
-}
-.home-chat-input:focus {
-  border-color: var(--accent);
-  box-shadow: 0 0 0 3px rgba(124, 58, 237, 0.18);
-}
-
-.home-chat-send-btn {
-  flex-shrink: 0;
-  width: 34px;
-  height: 34px;
-  border-radius: 50%;
-  border: none;
-  background: var(--accent);
-  color: #fff;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  cursor: pointer;
-  transition: opacity 0.15s, transform 0.1s;
-}
-.home-chat-send-btn:disabled {
-  opacity: 0.4;
-  cursor: default;
-}
-.home-chat-send-btn:not(:disabled):hover { opacity: 0.9; }
-.home-chat-send-btn:not(:disabled):active { transform: scale(0.95); }
-.home-chat-send-btn .lucide {
-  width: 16px;
-  height: 16px;
-}
-
-/* --- Mobile / narrow ---
-   On phones the popover fills the screen edge-to-edge with a small
-   inset, and the FAB shrinks slightly. */
-
-@media (max-width: 768px) {
-  /* Lift the FAB above the mobile tab bar (56px + safe-bottom).
-     Only applies when JS hasn't placed the FAB at a custom position
-     (custom positions use inline top/left and override these defaults). */
-  .clay-fab:not(.user-positioned) {
-    right: 14px;
-    bottom: calc(56px + var(--safe-bottom, 0px) + 14px);
-  }
-  .clay-fab {
-    width: 44px;
-    height: 44px;
-  }
-  .clay-fab-icon {
-    width: 30px;
-    height: 30px;
-  }
-}
-
-@media (max-width: 600px) {
-  .clay-popover {
-    right: 8px;
-    bottom: calc(56px + var(--safe-bottom, 0px) + 8px);
-    left: 8px;
-    width: auto;
-    height: 70vh;
-    max-height: calc(100vh - 80px - var(--safe-bottom, 0px));
-  }
-  .clay-popover .home-chat-frame {
-    border-radius: 16px;
-  }
-}
-
-/* When the mobile tab bar is hidden by the keyboard, drop the FAB back
-   down so it doesn't float in dead space. */
-@media (max-width: 768px) {
-  #mobile-tab-bar.keyboard-hidden ~ .clay-fab,
-  body:has(#mobile-tab-bar.keyboard-hidden) .clay-fab {
-    bottom: 14px;
-  }
-}
-
-/* Hide FAB while user is on auth/setup pages or any modal-heavy screens.
-   Add the class .clay-fab-suppressed on <body> when needed. */
-body.clay-fab-suppressed .clay-fab,
-body.clay-fab-suppressed .clay-popover {
-  display: none !important;
-}