@kkelly-offical/kkcode 0.1.7 → 0.2.3-preview.1

package/src/knowledge/frontend-aesthetics.txt

@@ -1,39 +1,39 @@
-<frontend_aesthetics>
-## Frontend Design Quality Rules
-
-When building frontend UI, avoid generic "AI-generated" aesthetics. Make creative, distinctive choices.
-
-### Typography
-- Avoid default fonts (Inter, Roboto, Arial, system-ui). Choose distinctive fonts.
-- Use high contrast: pair display fonts with monospace, serif with geometric sans.
-- Use extreme weight differences (200 vs 800) and 3x+ size jumps.
-- Load fonts from Google Fonts via <link> or @import.
-
-### Color
-- Define ALL colors as CSS variables in :root.
-- Use a dominant color with 1-2 sharp accents. Avoid evenly-distributed palettes.
-- Draw from real palettes: IDE themes (Nord, Catppuccin, Dracula), nature, cultural aesthetics.
-- AVOID: purple gradients on white, generic blue buttons, gray-on-gray cards.
-
-### Motion
-- One high-impact animation per page (staggered reveal on load).
-- Micro-interactions: hover lift, focus glow, press feedback.
-- Use CSS transitions/animations. Use animation-delay for staggered effects.
-
-### Layout
-- CSS Grid for page structure, Flexbox for components.
-- Generous whitespace. Consistent spacing scale (4/8/12/16/24/32/48/64px).
-- Mobile-first responsive design.
-
-### Depth & Atmosphere
-- Layered gradients, subtle patterns, backdrop-filter for glass effects.
-- Elevation hierarchy via box-shadow (not just border).
-- Noise/grain textures for premium feel.
-
-### What NOT to do
-- Cookie-cutter card grids with identical rounded corners
-- Generic hero with centered text + gradient
-- border-radius: 9999px on everything
-- Gray placeholder text that looks like wireframe
-- No visual rhythm (identical spacing everywhere)
+<frontend_aesthetics>
+## Frontend Design Quality Rules
+
+When building frontend UI, avoid generic "AI-generated" aesthetics. Make creative, distinctive choices.
+
+### Typography
+- Avoid default fonts (Inter, Roboto, Arial, system-ui). Choose distinctive fonts.
+- Use high contrast: pair display fonts with monospace, serif with geometric sans.
+- Use extreme weight differences (200 vs 800) and 3x+ size jumps.
+- Load fonts from Google Fonts via <link> or @import.
+
+### Color
+- Define ALL colors as CSS variables in :root.
+- Use a dominant color with 1-2 sharp accents. Avoid evenly-distributed palettes.
+- Draw from real palettes: IDE themes (Nord, Catppuccin, Dracula), nature, cultural aesthetics.
+- AVOID: purple gradients on white, generic blue buttons, gray-on-gray cards.
+
+### Motion
+- One high-impact animation per page (staggered reveal on load).
+- Micro-interactions: hover lift, focus glow, press feedback.
+- Use CSS transitions/animations. Use animation-delay for staggered effects.
+
+### Layout
+- CSS Grid for page structure, Flexbox for components.
+- Generous whitespace. Consistent spacing scale (4/8/12/16/24/32/48/64px).
+- Mobile-first responsive design.
+
+### Depth & Atmosphere
+- Layered gradients, subtle patterns, backdrop-filter for glass effects.
+- Elevation hierarchy via box-shadow (not just border).
+- Noise/grain textures for premium feel.
+
+### What NOT to do
+- Cookie-cutter card grids with identical rounded corners
+- Generic hero with centered text + gradient
+- border-radius: 9999px on everything
+- Gray placeholder text that looks like wireframe
+- No visual rhythm (identical spacing everywhere)
 </frontend_aesthetics>

package/src/mcp/client-http.mjs

@@ -1,141 +1,139 @@
-import { McpError } from "../core/errors.mjs"
-import { EventBus } from "../core/events.mjs"
-import { EVENT_TYPES } from "../core/constants.mjs"
-import { normalizeToolResult } from "./tool-result.mjs"
-
-function timeoutSignal(ms, parentSignal = null) {
-  const own = AbortSignal.timeout(ms)
-  if (!parentSignal) return own
-  return AbortSignal.any([parentSignal, own])
-}
-
-function classifyHttpError(error, status = null) {
-  const msg = String(error?.message || error || "")
-  if (msg.includes("AbortError") || msg.includes("timeout") || msg.includes("abort")) return "timeout"
-  if (msg.includes("ECONNREFUSED") || msg.includes("fetch failed")) return "connection_refused"
-  if (status && status >= 500) return "server_crash"
-  if (status && status >= 400) return "bad_response"
-  return "unknown"
-}
-
-async function requestJson({ serverName, method, url, body = null, timeoutMs = 10000, headers = {}, signal = null }) {
-  const action = method === "GET" ? url.split("/").pop() : body?.args ? "call_tool" : "request"
-  const startedAt = Date.now()
-  let status = null
-
-  try {
-    const res = await fetch(url, {
-      method,
-      headers: {
-        "content-type": "application/json",
-        ...headers
-      },
-      body: body ? JSON.stringify(body) : undefined,
-      signal: timeoutSignal(timeoutMs, signal)
-    })
-
-    status = res.status
-    const elapsed = Date.now() - startedAt
-
-    EventBus.emit({
-      type: EVENT_TYPES.MCP_REQUEST,
-      payload: { server: serverName, action, method, elapsed, status }
-    }).catch(() => {})
-
-    if (!res.ok) {
-      const text = await res.text().catch(() => "")
-      const reason = classifyHttpError(null, status)
-      throw new McpError(
-        `mcp server "${serverName}" HTTP ${status} on ${method} ${url}: ${text.slice(0, 500)}`,
-        { reason, server: serverName, action, phase: "request", statusCode: status }
-      )
-    }
-    return res.json().catch((parseErr) => {
-      const action = body?.args ? "call_tool" : "request"
-      EventBus.emit({
-        type: EVENT_TYPES.MCP_REQUEST,
-        payload: { server: serverName, action, warning: "malformed_json_response", detail: parseErr.message }
-      }).catch(() => {})
-      return {}
-    })
-  } catch (error) {
-    if (error instanceof McpError) throw error
-    const reason = classifyHttpError(error, status)
-    throw new McpError(
-      `mcp server "${serverName}" ${reason} on ${method} ${url}: ${error.message}`,
-      { reason, server: serverName, action, phase: "request", statusCode: status }
-    )
-  }
-}
-
-export function createHttpMcpClient(serverName, config) {
-  const baseUrl = String(config.url || "").replace(/\/$/, "")
-  const timeoutMs = Number(config.timeout_ms || 10000)
-  const headers = config.headers || {}
-
-  return {
-    serverName,
-    transport: "http",
-    async health() {
-      try {
-        await requestJson({ serverName, method: "GET", url: `${baseUrl}/health`, timeoutMs, headers })
-        return { ok: true }
-      } catch (error) {
-        return { ok: false, error: error.message, reason: error.reason || "unknown" }
-      }
-    },
-    async listTools() {
-      const out = await requestJson({ serverName, method: "GET", url: `${baseUrl}/tools`, timeoutMs, headers })
-      return Array.isArray(out?.tools) ? out.tools : []
-    },
-    async listPrompts() {
-      try {
-        const out = await requestJson({ serverName, method: "GET", url: `${baseUrl}/prompts`, timeoutMs, headers })
-        return Array.isArray(out?.prompts) ? out.prompts : []
-      } catch {
-        return []
-      }
-    },
-    async getPrompt(name, args = {}) {
-      return requestJson({
-        serverName,
-        method: "POST",
-        url: `${baseUrl}/prompts/${encodeURIComponent(name)}`,
-        body: { arguments: args },
-        timeoutMs,
-        headers
-      })
-    },
-    async listResources() {
-      try {
-        const out = await requestJson({ serverName, method: "GET", url: `${baseUrl}/resources`, timeoutMs, headers })
-        return Array.isArray(out?.resources) ? out.resources : []
-      } catch {
-        return []
-      }
-    },
-    async listTemplates() {
-      try {
-        const out = await requestJson({ serverName, method: "GET", url: `${baseUrl}/templates`, timeoutMs, headers })
-        return Array.isArray(out?.templates) ? out.templates : []
-      } catch {
-        return []
-      }
-    },
-    async callTool(name, args = {}, signal = null) {
-      const result = await requestJson({
-        serverName,
-        method: "POST",
-        url: `${baseUrl}/tools/${encodeURIComponent(name)}`,
-        body: { args },
-        timeoutMs,
-        headers,
-        signal
-      })
-      return normalizeToolResult(result, serverName, name)
-    },
-    shutdown() {
-      // HTTP client is stateless — no persistent connections to clean up
-    }
-  }
-}
+import { McpError } from "../core/errors.mjs"
+import { EventBus } from "../core/events.mjs"
+import { EVENT_TYPES } from "../core/constants.mjs"
+import { normalizeToolResult } from "./tool-result.mjs"
+
+function timeoutSignal(ms, parentSignal = null) {
+  const own = AbortSignal.timeout(ms)
+  if (!parentSignal) return own
+  return AbortSignal.any([parentSignal, own])
+}
+
+function classifyHttpError(error, status = null) {
+  const msg = String(error?.message || error || "")
+  if (msg.includes("AbortError") || msg.includes("timeout") || msg.includes("abort")) return "timeout"
+  if (msg.includes("ECONNREFUSED") || msg.includes("fetch failed")) return "connection_refused"
+  if (status && status >= 500) return "server_crash"
+  if (status && status >= 400) return "bad_response"
+  return "unknown"
+}
+
+async function requestJson({ serverName, method, url, body = null, timeoutMs = 10000, headers = {}, signal = null }) {
+  const action = method === "GET" ? url.split("/").pop() : body?.args ? "call_tool" : "request"
+  const startedAt = Date.now()
+  let status = null
+
+  try {
+    const res = await fetch(url, {
+      method,
+      headers: {
+        "content-type": "application/json",
+        ...headers
+      },
+      body: body ? JSON.stringify(body) : undefined,
+      signal: timeoutSignal(timeoutMs, signal)
+    })
+
+    status = res.status
+    const elapsed = Date.now() - startedAt
+
+    EventBus.emit({
+      type: EVENT_TYPES.MCP_REQUEST,
+      payload: { server: serverName, action, method, elapsed, status }
+    }).catch(() => {})
+
+    if (!res.ok) {
+      const text = await res.text().catch(() => "")
+      const reason = classifyHttpError(null, status)
+      throw new McpError(
+        `mcp server "${serverName}" HTTP ${status} on ${method} ${url}: ${text.slice(0, 500)}`,
+        { reason, server: serverName, action, phase: "request", statusCode: status }
+      )
+    }
+    return res.json().catch((parseErr) => {
+      throw new McpError(
+        `mcp server "${serverName}" malformed JSON response: ${parseErr.message}`,
+        { reason: "bad_response", server: serverName, action: body?.method || "request", phase: "request" }
+      )
+    })
+  } catch (error) {
+    if (error instanceof McpError) throw error
+    const reason = classifyHttpError(error, status)
+    throw new McpError(
+      `mcp server "${serverName}" ${reason} on ${method} ${url}: ${error.message}`,
+      { reason, server: serverName, action, phase: "request", statusCode: status }
+    )
+  }
+}
+
+export function createHttpMcpClient(serverName, config) {
+  const baseUrl = String(config.url || "").replace(/\/$/, "")
+  const timeoutMs = Number(config.timeout_ms || 10000)
+  const headers = config.headers || {}
+
+  return {
+    serverName,
+    transport: "http",
+    async health() {
+      try {
+        await requestJson({ serverName, method: "GET", url: `${baseUrl}/health`, timeoutMs, headers })
+        return { ok: true }
+      } catch (error) {
+        return { ok: false, error: error.message, reason: error.reason || "unknown" }
+      }
+    },
+    async listTools() {
+      const out = await requestJson({ serverName, method: "GET", url: `${baseUrl}/tools`, timeoutMs, headers })
+      return Array.isArray(out?.tools) ? out.tools : []
+    },
+    async listPrompts() {
+      try {
+        const out = await requestJson({ serverName, method: "GET", url: `${baseUrl}/prompts`, timeoutMs, headers })
+        return Array.isArray(out?.prompts) ? out.prompts : []
+      } catch {
+        return []
+      }
+    },
+    async getPrompt(name, args = {}) {
+      return requestJson({
+        serverName,
+        method: "POST",
+        url: `${baseUrl}/prompts/${encodeURIComponent(name)}`,
+        body: { arguments: args },
+        timeoutMs,
+        headers
+      })
+    },
+    async listResources() {
+      try {
+        const out = await requestJson({ serverName, method: "GET", url: `${baseUrl}/resources`, timeoutMs, headers })
+        return Array.isArray(out?.resources) ? out.resources : []
+      } catch {
+        return []
+      }
+    },
+    async listTemplates() {
+      try {
+        const out = await requestJson({ serverName, method: "GET", url: `${baseUrl}/templates`, timeoutMs, headers })
+        return Array.isArray(out?.templates) ? out.templates : []
+      } catch {
+        return []
+      }
+    },
+    async callTool(name, args = {}, signal = null) {
+      const result = await requestJson({
+        serverName,
+        method: "POST",
+        url: `${baseUrl}/tools/${encodeURIComponent(name)}`,
+        body: { arguments: args },
+        timeoutMs,
+        headers,
+        signal
+      })
+      return normalizeToolResult(result, serverName, name)
+    },
+    shutdown() {
+      // HTTP client is stateless — no persistent connections to clean up
+    }
+  }
+}