@kongyo2/mcp-request-context 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 kongyo2
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/core/storage.d.ts

@@ -0,0 +1,31 @@
+import { EventEmitter } from 'events';
+import { Result } from 'neverthrow';
+import { ContextRequest, CreateContextRequestInput, ContextResponseInput } from './types.js';
+export declare class StorageError extends Error {
+    readonly code: StorageErrorCode;
+    constructor(message: string, code: StorageErrorCode);
+}
+export type StorageErrorCode = 'NOT_FOUND' | 'VALIDATION_ERROR' | 'IO_ERROR' | 'ALREADY_ANSWERED' | 'INVALID_STATUS';
+export type StorageResult<T> = Result<T, StorageError>;
+export declare class ContextStorage extends EventEmitter {
+    private storagePath;
+    private watcher?;
+    private pendingEmit;
+    private readonly DEBOUNCE_MS;
+    constructor(basePath: string);
+    initialize(): Promise<StorageResult<void>>;
+    start(): Promise<StorageResult<void>>;
+    stop(): Promise<void>;
+    private scheduleChangeEmit;
+    createRequest(input: CreateContextRequestInput): Promise<StorageResult<ContextRequest>>;
+    getRequest(id: string): Promise<StorageResult<ContextRequest>>;
+    answerRequest(input: ContextResponseInput): Promise<StorageResult<ContextRequest>>;
+    cancelRequest(id: string): Promise<StorageResult<ContextRequest>>;
+    getAllRequests(): Promise<StorageResult<ContextRequest[]>>;
+    getPendingRequests(): Promise<StorageResult<ContextRequest[]>>;
+    deleteRequest(id: string): Promise<StorageResult<void>>;
+    cleanupExpired(): Promise<StorageResult<number>>;
+    private updateStatus;
+    getStoragePath(): string;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/core/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/core/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC,OAAO,EAAE,MAAM,EAAW,MAAM,YAAY,CAAC;AAE7C,OAAO,EACL,cAAc,EAEd,yBAAyB,EAEzB,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAGpB,qBAAa,YAAa,SAAQ,KAAK;aAGnB,IAAI,EAAE,gBAAgB;gBADtC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,gBAAgB;CAKzC;AAED,MAAM,MAAM,gBAAgB,GACxB,WAAW,GACX,kBAAkB,GAClB,UAAU,GACV,kBAAkB,GAClB,gBAAgB,CAAC;AAErB,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;AAEvD,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAC,CAAqB;IACrC,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAO;gBAEvB,QAAQ,EAAE,MAAM;IAKtB,UAAU,IAAI,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAY1C,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IA8BrC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAe3B,OAAO,CAAC,kBAAkB;IAUpB,aAAa,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;IAqDvF,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;IA0B9D,aAAa,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;IAmClF,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;IAiCjE,cAAc,IAAI,OAAO,CAAC,aAAa,CAAC,cAAc,EAAE,CAAC,CAAC;IAgC1D,kBAAkB,IAAI,OAAO,CAAC,aAAa,CAAC,cAAc,EAAE,CAAC,CAAC;IAU9D,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAgBvD,cAAc,IAAI,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YAyBxC,YAAY;IA2B1B,cAAc,IAAI,MAAM;CAGzB"}

package/dist/core/types.d.ts

@@ -0,0 +1,128 @@
+import { z } from 'zod';
+export declare const ContextTypeSchema: z.ZodEnum<["url_content", "documentation", "dependency_info", "code_snippet", "configuration", "api_response", "error_context", "custom"]>;
+export type ContextType = z.infer<typeof ContextTypeSchema>;
+export declare const ContextPrioritySchema: z.ZodEnum<["critical", "high", "normal", "low"]>;
+export type ContextPriority = z.infer<typeof ContextPrioritySchema>;
+export declare const ContextRequestStatusSchema: z.ZodEnum<["pending", "answered", "cancelled", "expired"]>;
+export type ContextRequestStatus = z.infer<typeof ContextRequestStatusSchema>;
+export declare const ContextRequestSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodEnum<["url_content", "documentation", "dependency_info", "code_snippet", "configuration", "api_response", "error_context", "custom"]>;
+    priority: z.ZodEnum<["critical", "high", "normal", "low"]>;
+    status: z.ZodEnum<["pending", "answered", "cancelled", "expired"]>;
+    title: z.ZodString;
+    description: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+    hints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    expectedFormat: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    answeredAt: z.ZodOptional<z.ZodString>;
+    expiresAt: z.ZodOptional<z.ZodString>;
+    response: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    type: "url_content" | "documentation" | "dependency_info" | "code_snippet" | "configuration" | "api_response" | "error_context" | "custom";
+    status: "pending" | "answered" | "cancelled" | "expired";
+    id: string;
+    priority: "critical" | "high" | "normal" | "low";
+    title: string;
+    description: string;
+    createdAt: string;
+    url?: string | undefined;
+    hints?: string[] | undefined;
+    expectedFormat?: string | undefined;
+    answeredAt?: string | undefined;
+    expiresAt?: string | undefined;
+    response?: string | undefined;
+    tags?: string[] | undefined;
+}, {
+    type: "url_content" | "documentation" | "dependency_info" | "code_snippet" | "configuration" | "api_response" | "error_context" | "custom";
+    status: "pending" | "answered" | "cancelled" | "expired";
+    id: string;
+    priority: "critical" | "high" | "normal" | "low";
+    title: string;
+    description: string;
+    createdAt: string;
+    url?: string | undefined;
+    hints?: string[] | undefined;
+    expectedFormat?: string | undefined;
+    answeredAt?: string | undefined;
+    expiresAt?: string | undefined;
+    response?: string | undefined;
+    tags?: string[] | undefined;
+}>;
+export type ContextRequest = z.infer<typeof ContextRequestSchema>;
+export declare const CreateContextRequestSchema: z.ZodObject<{
+    type: z.ZodEnum<["url_content", "documentation", "dependency_info", "code_snippet", "configuration", "api_response", "error_context", "custom"]>;
+    priority: z.ZodDefault<z.ZodEnum<["critical", "high", "normal", "low"]>>;
+    title: z.ZodString;
+    description: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+    hints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    expectedFormat: z.ZodOptional<z.ZodString>;
+    expiresInMinutes: z.ZodOptional<z.ZodNumber>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    type: "url_content" | "documentation" | "dependency_info" | "code_snippet" | "configuration" | "api_response" | "error_context" | "custom";
+    priority: "critical" | "high" | "normal" | "low";
+    title: string;
+    description: string;
+    url?: string | undefined;
+    hints?: string[] | undefined;
+    expectedFormat?: string | undefined;
+    tags?: string[] | undefined;
+    expiresInMinutes?: number | undefined;
+}, {
+    type: "url_content" | "documentation" | "dependency_info" | "code_snippet" | "configuration" | "api_response" | "error_context" | "custom";
+    title: string;
+    description: string;
+    priority?: "critical" | "high" | "normal" | "low" | undefined;
+    url?: string | undefined;
+    hints?: string[] | undefined;
+    expectedFormat?: string | undefined;
+    tags?: string[] | undefined;
+    expiresInMinutes?: number | undefined;
+}>;
+export type CreateContextRequestInput = z.infer<typeof CreateContextRequestSchema>;
+export declare const ContextResponseSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    response: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    response: string;
+    requestId: string;
+}, {
+    response: string;
+    requestId: string;
+}>;
+export type ContextResponseInput = z.infer<typeof ContextResponseSchema>;
+export interface ToolResponse {
+    success: boolean;
+    message: string;
+    data?: unknown;
+    nextSteps?: string[];
+}
+export interface MCPToolResponse {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+    _meta?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface DashboardSession {
+    url: string;
+    port: number;
+    pid: number;
+    startedAt: string;
+}
+export declare const WSMessageTypeSchema: z.ZodEnum<["initial", "request-created", "request-updated", "request-answered", "request-cancelled", "ping", "pong"]>;
+export type WSMessageType = z.infer<typeof WSMessageTypeSchema>;
+export interface WSMessage {
+    type: WSMessageType;
+    data?: unknown;
+    timestamp: string;
+}
+export declare function toMCPResponse(response: ToolResponse, isError?: boolean): MCPToolResponse;
+export declare function generateId(prefix?: string): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,iBAAiB,4IAS5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,qBAAqB,kDAKhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,0BAA0B,4DAKrC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAG9E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyB/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAGlE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUrC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAGnF,eAAO,MAAM,qBAAqB;;;;;;;;;EAGhC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAGzE,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAGD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAGD,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD,eAAO,MAAM,mBAAmB,uHAQ9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,UAAQ,GAAG,eAAe,CAQtF;AAGD,wBAAgB,UAAU,CAAC,MAAM,SAAQ,GAAG,MAAM,CAEjD"}

package/dist/dashboard/public/index.html

@@ -0,0 +1,625 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>MCP Request Context - Dashboard</title>
+  <style>
+    :root {
+      --bg-primary: #0f0f0f;
+      --bg-secondary: #1a1a1a;
+      --bg-tertiary: #252525;
+      --text-primary: #ffffff;
+      --text-secondary: #a0a0a0;
+      --accent: #6366f1;
+      --accent-hover: #4f46e5;
+      --success: #22c55e;
+      --warning: #f59e0b;
+      --error: #ef4444;
+      --critical: #dc2626;
+      --border: #333333;
+      --radius: 8px;
+    }
+
+    * {
+      box-sizing: border-box;
+      margin: 0;
+      padding: 0;
+    }
+
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+      background: var(--bg-primary);
+      color: var(--text-primary);
+      line-height: 1.6;
+      min-height: 100vh;
+    }
+
+    .container {
+      max-width: 1200px;
+      margin: 0 auto;
+      padding: 24px;
+    }
+
+    header {
+      display: flex;
+      justify-content: space-between;
+      align-items: center;
+      margin-bottom: 32px;
+      padding-bottom: 16px;
+      border-bottom: 1px solid var(--border);
+    }
+
+    header h1 {
+      font-size: 24px;
+      font-weight: 600;
+    }
+
+    .status-badge {
+      display: flex;
+      align-items: center;
+      gap: 8px;
+      padding: 6px 12px;
+      background: var(--bg-secondary);
+      border-radius: 20px;
+      font-size: 14px;
+    }
+
+    .status-dot {
+      width: 8px;
+      height: 8px;
+      border-radius: 50%;
+      background: var(--success);
+      animation: pulse 2s infinite;
+    }
+
+    @keyframes pulse {
+      0%, 100% { opacity: 1; }
+      50% { opacity: 0.5; }
+    }
+
+    .section-title {
+      font-size: 18px;
+      font-weight: 500;
+      margin-bottom: 16px;
+      color: var(--text-secondary);
+    }
+
+    .request-list {
+      display: flex;
+      flex-direction: column;
+      gap: 16px;
+    }
+
+    .request-card {
+      background: var(--bg-secondary);
+      border: 1px solid var(--border);
+      border-radius: var(--radius);
+      padding: 20px;
+      transition: border-color 0.2s;
+    }
+
+    .request-card:hover {
+      border-color: var(--accent);
+    }
+
+    .request-card.priority-critical {
+      border-left: 4px solid var(--critical);
+    }
+
+    .request-card.priority-high {
+      border-left: 4px solid var(--warning);
+    }
+
+    .request-card.priority-normal {
+      border-left: 4px solid var(--accent);
+    }
+
+    .request-card.priority-low {
+      border-left: 4px solid var(--text-secondary);
+    }
+
+    .request-header {
+      display: flex;
+      justify-content: space-between;
+      align-items: flex-start;
+      margin-bottom: 12px;
+    }
+
+    .request-title {
+      font-size: 16px;
+      font-weight: 500;
+    }
+
+    .request-meta {
+      display: flex;
+      gap: 8px;
+      flex-wrap: wrap;
+    }
+
+    .tag {
+      padding: 4px 8px;
+      border-radius: 4px;
+      font-size: 12px;
+      font-weight: 500;
+    }
+
+    .tag.type {
+      background: var(--bg-tertiary);
+      color: var(--text-secondary);
+    }
+
+    .tag.priority {
+      background: var(--accent);
+      color: white;
+    }
+
+    .tag.priority-critical {
+      background: var(--critical);
+    }
+
+    .tag.priority-high {
+      background: var(--warning);
+    }
+
+    .tag.status {
+      background: var(--success);
+      color: white;
+    }
+
+    .tag.status-pending {
+      background: var(--warning);
+    }
+
+    .tag.status-answered {
+      background: var(--success);
+    }
+
+    .tag.status-cancelled {
+      background: var(--text-secondary);
+    }
+
+    .request-description {
+      color: var(--text-secondary);
+      margin-bottom: 16px;
+      white-space: pre-wrap;
+    }
+
+    .request-url {
+      display: block;
+      color: var(--accent);
+      margin-bottom: 12px;
+      word-break: break-all;
+    }
+
+    .request-hints {
+      background: var(--bg-tertiary);
+      padding: 12px;
+      border-radius: var(--radius);
+      margin-bottom: 16px;
+    }
+
+    .request-hints h4 {
+      font-size: 12px;
+      color: var(--text-secondary);
+      margin-bottom: 8px;
+    }
+
+    .request-hints ul {
+      list-style: disc;
+      padding-left: 20px;
+      font-size: 14px;
+    }
+
+    .response-form {
+      display: flex;
+      flex-direction: column;
+      gap: 12px;
+    }
+
+    .response-textarea {
+      width: 100%;
+      min-height: 150px;
+      padding: 12px;
+      background: var(--bg-tertiary);
+      border: 1px solid var(--border);
+      border-radius: var(--radius);
+      color: var(--text-primary);
+      font-family: 'Monaco', 'Menlo', monospace;
+      font-size: 14px;
+      resize: vertical;
+    }
+
+    .response-textarea:focus {
+      outline: none;
+      border-color: var(--accent);
+    }
+
+    .response-actions {
+      display: flex;
+      gap: 12px;
+    }
+
+    button {
+      padding: 10px 20px;
+      border: none;
+      border-radius: var(--radius);
+      font-size: 14px;
+      font-weight: 500;
+      cursor: pointer;
+      transition: all 0.2s;
+    }
+
+    .btn-primary {
+      background: var(--accent);
+      color: white;
+    }
+
+    .btn-primary:hover {
+      background: var(--accent-hover);
+    }
+
+    .btn-secondary {
+      background: var(--bg-tertiary);
+      color: var(--text-primary);
+    }
+
+    .btn-secondary:hover {
+      background: var(--border);
+    }
+
+    .btn-danger {
+      background: var(--error);
+      color: white;
+    }
+
+    .btn-danger:hover {
+      background: var(--critical);
+    }
+
+    .empty-state {
+      text-align: center;
+      padding: 60px 20px;
+      color: var(--text-secondary);
+    }
+
+    .empty-state h2 {
+      font-size: 20px;
+      margin-bottom: 8px;
+      color: var(--text-primary);
+    }
+
+    .request-time {
+      font-size: 12px;
+      color: var(--text-secondary);
+      margin-top: 12px;
+    }
+
+    .answered-response {
+      background: var(--bg-tertiary);
+      padding: 12px;
+      border-radius: var(--radius);
+      margin-top: 12px;
+      font-family: 'Monaco', 'Menlo', monospace;
+      font-size: 14px;
+      white-space: pre-wrap;
+      word-break: break-word;
+    }
+
+    .tabs {
+      display: flex;
+      gap: 4px;
+      margin-bottom: 24px;
+      background: var(--bg-secondary);
+      padding: 4px;
+      border-radius: var(--radius);
+      width: fit-content;
+    }
+
+    .tab {
+      padding: 8px 16px;
+      border: none;
+      background: transparent;
+      color: var(--text-secondary);
+      cursor: pointer;
+      border-radius: 6px;
+      font-size: 14px;
+      transition: all 0.2s;
+    }
+
+    .tab.active {
+      background: var(--accent);
+      color: white;
+    }
+
+    .tab:hover:not(.active) {
+      background: var(--bg-tertiary);
+      color: var(--text-primary);
+    }
+
+    .notification {
+      position: fixed;
+      bottom: 24px;
+      right: 24px;
+      padding: 12px 20px;
+      background: var(--success);
+      color: white;
+      border-radius: var(--radius);
+      animation: slideIn 0.3s ease-out;
+      z-index: 1000;
+    }
+
+    @keyframes slideIn {
+      from {
+        transform: translateX(100%);
+        opacity: 0;
+      }
+      to {
+        transform: translateX(0);
+        opacity: 1;
+      }
+    }
+
+    .notification.error {
+      background: var(--error);
+    }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <header>
+      <h1>MCP Request Context</h1>
+      <div class="status-badge">
+        <div class="status-dot"></div>
+        <span>Connected</span>
+      </div>
+    </header>
+
+    <div class="tabs">
+      <button class="tab active" data-tab="pending">Pending</button>
+      <button class="tab" data-tab="all">All Requests</button>
+    </div>
+
+    <div id="pending-section">
+      <h2 class="section-title">Pending Requests</h2>
+      <div id="pending-requests" class="request-list">
+        <div class="empty-state">
+          <h2>No pending requests</h2>
+          <p>When an LLM agent requests context, it will appear here.</p>
+        </div>
+      </div>
+    </div>
+
+    <div id="all-section" style="display: none;">
+      <h2 class="section-title">All Requests</h2>
+      <div id="all-requests" class="request-list">
+        <div class="empty-state">
+          <h2>No requests yet</h2>
+          <p>Requests will appear here once created.</p>
+        </div>
+      </div>
+    </div>
+  </div>
+
+  <script>
+    const ws = new WebSocket(`ws://${window.location.host}/ws`);
+    let requests = [];
+
+    ws.onopen = () => {
+      console.log('WebSocket connected');
+      updateConnectionStatus(true);
+    };
+
+    ws.onclose = () => {
+      console.log('WebSocket disconnected');
+      updateConnectionStatus(false);
+    };
+
+    ws.onmessage = (event) => {
+      const message = JSON.parse(event.data);
+      handleMessage(message);
+    };
+
+    function updateConnectionStatus(connected) {
+      const badge = document.querySelector('.status-badge');
+      const dot = document.querySelector('.status-dot');
+      if (connected) {
+        badge.querySelector('span').textContent = 'Connected';
+        dot.style.background = 'var(--success)';
+      } else {
+        badge.querySelector('span').textContent = 'Disconnected';
+        dot.style.background = 'var(--error)';
+      }
+    }
+
+    function handleMessage(message) {
+      switch (message.type) {
+        case 'initial':
+          requests = message.data;
+          renderRequests();
+          break;
+        case 'request-created':
+          requests.unshift(message.data);
+          renderRequests();
+          showNotification('New context request received');
+          break;
+        case 'request-answered':
+        case 'request-cancelled':
+        case 'request-updated':
+          if (Array.isArray(message.data)) {
+            requests = message.data;
+          } else {
+            const index = requests.findIndex(r => r.id === message.data.id);
+            if (index !== -1) {
+              requests[index] = message.data;
+            }
+          }
+          renderRequests();
+          break;
+      }
+    }
+
+    function renderRequests() {
+      const pendingContainer = document.getElementById('pending-requests');
+      const allContainer = document.getElementById('all-requests');
+
+      const pending = requests.filter(r => r.status === 'pending');
+
+      pendingContainer.innerHTML = pending.length === 0
+        ? `<div class="empty-state">
+            <h2>No pending requests</h2>
+            <p>When an LLM agent requests context, it will appear here.</p>
+          </div>`
+        : pending.map(renderRequestCard).join('');
+
+      allContainer.innerHTML = requests.length === 0
+        ? `<div class="empty-state">
+            <h2>No requests yet</h2>
+            <p>Requests will appear here once created.</p>
+          </div>`
+        : requests.map(r => renderRequestCard(r, true)).join('');
+    }
+
+    function renderRequestCard(request, showStatus = false) {
+      const isPending = request.status === 'pending';
+      const priorityClass = `priority-${request.priority}`;
+
+      return `
+        <div class="request-card ${priorityClass}">
+          <div class="request-header">
+            <h3 class="request-title">${escapeHtml(request.title)}</h3>
+            <div class="request-meta">
+              <span class="tag type">${request.type.replace('_', ' ')}</span>
+              <span class="tag priority ${priorityClass}">${request.priority}</span>
+              ${showStatus ? `<span class="tag status status-${request.status}">${request.status}</span>` : ''}
+            </div>
+          </div>
+
+          <p class="request-description">${escapeHtml(request.description)}</p>
+
+          ${request.url ? `<a href="${escapeHtml(request.url)}" target="_blank" class="request-url">${escapeHtml(request.url)}</a>` : ''}
+
+          ${request.hints && request.hints.length > 0 ? `
+            <div class="request-hints">
+              <h4>Hints</h4>
+              <ul>
+                ${request.hints.map(h => `<li>${escapeHtml(h)}</li>`).join('')}
+              </ul>
+            </div>
+          ` : ''}
+
+          ${request.expectedFormat ? `
+            <div class="request-hints">
+              <h4>Expected Format</h4>
+              <p>${escapeHtml(request.expectedFormat)}</p>
+            </div>
+          ` : ''}
+
+          ${isPending ? `
+            <div class="response-form">
+              <textarea
+                class="response-textarea"
+                id="response-${request.id}"
+                placeholder="Enter your response here..."
+              ></textarea>
+              <div class="response-actions">
+                <button class="btn-primary" onclick="submitResponse('${request.id}')">Submit Response</button>
+                <button class="btn-secondary" onclick="cancelRequest('${request.id}')">Cancel</button>
+              </div>
+            </div>
+          ` : ''}
+
+          ${request.status === 'answered' && request.response ? `
+            <div class="answered-response">${escapeHtml(request.response)}</div>
+          ` : ''}
+
+          <div class="request-time">
+            Created: ${formatDate(request.createdAt)}
+            ${request.answeredAt ? ` | Answered: ${formatDate(request.answeredAt)}` : ''}
+            ${request.expiresAt ? ` | Expires: ${formatDate(request.expiresAt)}` : ''}
+          </div>
+        </div>
+      `;
+    }
+
+    async function submitResponse(requestId) {
+      const textarea = document.getElementById(`response-${requestId}`);
+      const response = textarea.value.trim();
+
+      if (!response) {
+        showNotification('Please enter a response', true);
+        return;
+      }
+
+      try {
+        const res = await fetch(`/api/requests/${requestId}/answer`, {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ response })
+        });
+
+        if (!res.ok) {
+          throw new Error('Failed to submit response');
+        }
+
+        showNotification('Response submitted successfully');
+      } catch (error) {
+        showNotification('Failed to submit response', true);
+      }
+    }
+
+    async function cancelRequest(requestId) {
+      if (!confirm('Are you sure you want to cancel this request?')) {
+        return;
+      }
+
+      try {
+        const res = await fetch(`/api/requests/${requestId}/cancel`, {
+          method: 'POST'
+        });
+
+        if (!res.ok) {
+          throw new Error('Failed to cancel request');
+        }
+
+        showNotification('Request cancelled');
+      } catch (error) {
+        showNotification('Failed to cancel request', true);
+      }
+    }
+
+    function showNotification(message, isError = false) {
+      const notification = document.createElement('div');
+      notification.className = `notification ${isError ? 'error' : ''}`;
+      notification.textContent = message;
+      document.body.appendChild(notification);
+
+      setTimeout(() => {
+        notification.remove();
+      }, 3000);
+    }
+
+    function escapeHtml(text) {
+      const div = document.createElement('div');
+      div.textContent = text;
+      return div.innerHTML;
+    }
+
+    function formatDate(dateStr) {
+      return new Date(dateStr).toLocaleString();
+    }
+
+    // Tab switching
+    document.querySelectorAll('.tab').forEach(tab => {
+      tab.addEventListener('click', () => {
+        document.querySelectorAll('.tab').forEach(t => t.classList.remove('active'));
+        tab.classList.add('active');
+
+        const tabName = tab.dataset.tab;
+        document.getElementById('pending-section').style.display = tabName === 'pending' ? 'block' : 'none';
+        document.getElementById('all-section').style.display = tabName === 'all' ? 'block' : 'none';
+      });
+    });
+  </script>
+</body>
+</html>

package/dist/dashboard/server.d.ts

@@ -0,0 +1,25 @@
+import { ContextStorage } from '../core/storage.js';
+export interface DashboardOptions {
+    autoOpen?: boolean;
+    port?: number;
+}
+export declare class DashboardServer {
+    private app;
+    private storage;
+    private projectPath;
+    private options;
+    private clients;
+    private heartbeatInterval?;
+    private readonly HEARTBEAT_INTERVAL_MS;
+    constructor(projectPath: string, options?: DashboardOptions);
+    start(): Promise<string>;
+    private setupStorageEvents;
+    private sendInitialData;
+    private registerApiRoutes;
+    private broadcast;
+    private startHeartbeat;
+    private saveSession;
+    stop(): Promise<void>;
+    getStorage(): ContextStorage;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/dashboard/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/dashboard/server.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAUpD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,GAAG,CAAkB;IAC7B,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,iBAAiB,CAAC,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;gBAEnC,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB;IAOzD,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAuE9B,OAAO,CAAC,kBAAkB;YAqCZ,eAAe;IAY7B,OAAO,CAAC,iBAAiB;IAwFzB,OAAO,CAAC,SAAS;IAcjB,OAAO,CAAC,cAAc;YAcR,WAAW;IAiBnB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B3B,UAAU,IAAI,cAAc;CAG7B"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/server.d.ts

@@ -0,0 +1,13 @@
+import { ContextStorage } from './core/storage.js';
+export declare class RequestContextMCPServer {
+    private server;
+    private storage;
+    private projectPath;
+    private dashboardUrl?;
+    constructor(projectPath: string);
+    initialize(): Promise<void>;
+    private registerTools;
+    stop(): Promise<void>;
+    getStorage(): ContextStorage;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AA+BnD,qBAAa,uBAAuB;IAClC,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAC,CAAS;gBAElB,WAAW,EAAE,MAAM;IAsBzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA2DjC,OAAO,CAAC,aAAa;IAwDf,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,UAAU,IAAI,cAAc;CAG7B"}

package/dist/tools/get-context-response.d.ts

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+import { ContextStorage } from '../core/storage.js';
+import { MCPToolResponse } from '../core/types.js';
+export declare const GetContextResponseInputSchema: z.ZodObject<{
+    requestId: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    requestId: string;
+}, {
+    requestId: string;
+}>;
+export type GetContextResponseInput = z.infer<typeof GetContextResponseInputSchema>;
+export declare const GET_CONTEXT_RESPONSE_TOOL_NAME = "get_context_response";
+export declare const GET_CONTEXT_RESPONSE_TOOL_TITLE = "Get Context Response";
+export declare const GET_CONTEXT_RESPONSE_TOOL_DESCRIPTION = "Check the status of a context request and retrieve the human's response.\n\nUse this tool to poll for responses after creating a context request with 'request_context'.\n\n## Status Values\n- pending: Human has not yet responded\n- answered: Human has provided the requested information\n- cancelled: Request was cancelled\n- expired: Request expired without a response\n\nWhen status is 'answered', the response field contains the information provided by the human.";
+export declare const GET_CONTEXT_RESPONSE_ANNOTATIONS: {
+    readOnlyHint: boolean;
+    destructiveHint: boolean;
+    idempotentHint: boolean;
+    openWorldHint: boolean;
+};
+export declare function getContextResponseHandler(args: GetContextResponseInput, storage: ContextStorage, dashboardUrl?: string): Promise<MCPToolResponse>;
+//# sourceMappingURL=get-context-response.d.ts.map

package/dist/tools/get-context-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-context-response.d.ts","sourceRoot":"","sources":["../../src/tools/get-context-response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAA+B,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGhF,eAAO,MAAM,6BAA6B;;;;;;EAI/B,CAAC;AAEZ,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAEpF,eAAO,MAAM,8BAA8B,yBAAyB,CAAC;AAErE,eAAO,MAAM,+BAA+B,yBAAyB,CAAC;AAEtE,eAAO,MAAM,qCAAqC,udAU4C,CAAC;AAE/F,eAAO,MAAM,gCAAgC;;;;;CAK5C,CAAC;AAEF,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,uBAAuB,EAC7B,OAAO,EAAE,cAAc,EACvB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,eAAe,CAAC,CAyD1B"}

package/dist/tools/index.d.ts

@@ -0,0 +1,8 @@
+import { ContextStorage } from '../core/storage.js';
+export { RequestContextInputSchema, RequestContextInput, REQUEST_CONTEXT_TOOL_NAME, REQUEST_CONTEXT_TOOL_TITLE, REQUEST_CONTEXT_TOOL_DESCRIPTION, REQUEST_CONTEXT_ANNOTATIONS, requestContextHandler } from './request-context.js';
+export { GetContextResponseInputSchema, GetContextResponseInput, GET_CONTEXT_RESPONSE_TOOL_NAME, GET_CONTEXT_RESPONSE_TOOL_TITLE, GET_CONTEXT_RESPONSE_TOOL_DESCRIPTION, GET_CONTEXT_RESPONSE_ANNOTATIONS, getContextResponseHandler } from './get-context-response.js';
+export interface ToolContext {
+    storage: ContextStorage;
+    dashboardUrl?: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,EAC1B,gCAAgC,EAChC,2BAA2B,EAC3B,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,6BAA6B,EAC7B,uBAAuB,EACvB,8BAA8B,EAC9B,+BAA+B,EAC/B,qCAAqC,EACrC,gCAAgC,EAChC,yBAAyB,EAC1B,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,cAAc,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/tools/request-context.d.ts

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+import { ContextStorage } from '../core/storage.js';
+import { MCPToolResponse } from '../core/types.js';
+export declare const RequestContextInputSchema: z.ZodObject<{
+    type: z.ZodEnum<["url_content", "documentation", "dependency_info", "code_snippet", "configuration", "api_response", "error_context", "custom"]>;
+    priority: z.ZodDefault<z.ZodEnum<["critical", "high", "normal", "low"]>>;
+    title: z.ZodString;
+    description: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+    hints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    expectedFormat: z.ZodOptional<z.ZodString>;
+    expiresInMinutes: z.ZodOptional<z.ZodNumber>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strict", z.ZodTypeAny, {
+    type: "url_content" | "documentation" | "dependency_info" | "code_snippet" | "configuration" | "api_response" | "error_context" | "custom";
+    priority: "critical" | "high" | "normal" | "low";
+    title: string;
+    description: string;
+    url?: string | undefined;
+    hints?: string[] | undefined;
+    expectedFormat?: string | undefined;
+    tags?: string[] | undefined;
+    expiresInMinutes?: number | undefined;
+}, {
+    type: "url_content" | "documentation" | "dependency_info" | "code_snippet" | "configuration" | "api_response" | "error_context" | "custom";
+    title: string;
+    description: string;
+    priority?: "critical" | "high" | "normal" | "low" | undefined;
+    url?: string | undefined;
+    hints?: string[] | undefined;
+    expectedFormat?: string | undefined;
+    tags?: string[] | undefined;
+    expiresInMinutes?: number | undefined;
+}>;
+export type RequestContextInput = z.infer<typeof RequestContextInputSchema>;
+export declare const REQUEST_CONTEXT_TOOL_NAME = "request_context";
+export declare const REQUEST_CONTEXT_TOOL_TITLE = "Request Context from Human";
+export declare const REQUEST_CONTEXT_TOOL_DESCRIPTION = "Request context/information from a human operator.\n\nUse this tool when you need information that:\n- Is behind a URL you cannot access\n- Requires reading documentation that is difficult to parse\n- Involves dependency/API information the human can provide faster\n- Would take multiple turns to gather but the human can provide directly\n\nThe human will see your request in a dashboard UI and can respond with the needed information.\n\n## Context Types\n- url_content: Content from a URL you cannot access\n- documentation: API/library documentation content\n- dependency_info: Package/dependency information\n- code_snippet: Specific code snippets\n- configuration: Configuration file contents\n- api_response: Example API responses\n- error_context: Additional error context\n- custom: Any other type of context\n\n## Priority Levels\n- critical: Blocking - cannot proceed without this\n- high: Important - needed soon\n- normal: Standard priority\n- low: Nice to have\n\nAfter creating a request, poll the status using 'get_context_response' tool.";
+export declare const REQUEST_CONTEXT_ANNOTATIONS: {
+    readOnlyHint: boolean;
+    destructiveHint: boolean;
+    idempotentHint: boolean;
+    openWorldHint: boolean;
+};
+export declare function requestContextHandler(args: RequestContextInput, storage: ContextStorage, dashboardUrl?: string): Promise<MCPToolResponse>;
+//# sourceMappingURL=request-context.d.ts.map

package/dist/tools/request-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../../src/tools/request-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAA+B,eAAe,EAA4C,MAAM,kBAAkB,CAAC;AAG1H,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+B3B,CAAC;AAEZ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,yBAAyB,oBAAoB,CAAC;AAE3D,eAAO,MAAM,0BAA0B,+BAA+B,CAAC;AAEvE,eAAO,MAAM,gCAAgC,oiCA0BgC,CAAC;AAE9E,eAAO,MAAM,2BAA2B;;;;;CAKvC,CAAC;AAEF,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,cAAc,EACvB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,eAAe,CAAC,CA8C1B"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@kongyo2/mcp-request-context",
+  "version": "1.0.1",
+  "description": "MCP server for LLM agents to request context from humans - treating humans as a token-efficient API",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kongyo2/mcp-request-context.git"
+  },
+  "homepage": "https://github.com/kongyo2/mcp-request-context#readme",
+  "bugs": {
+    "url": "https://github.com/kongyo2/mcp-request-context/issues"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "mcp-request-context": "dist/index.js"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc && node scripts/copy-static.cjs",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "lint": "oxlint --silent",
+    "lint:strict": "oxlint --deny-warnings",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "context-request",
+    "ai-development",
+    "human-in-the-loop",
+    "llm-agent"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@fastify/cors": "^9.0.1",
+    "@fastify/static": "^7.0.4",
+    "@fastify/websocket": "^8.2.1",
+    "@modelcontextprotocol/sdk": "^1.24.3",
+    "chokidar": "^3.5.3",
+    "fastify": "^4.24.3",
+    "neverthrow": "^8.1.1",
+    "open": "^8.4.2",
+    "ws": "^8.18.0",
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.18.1",
+    "@types/ws": "^8.5.13",
+    "oxlint": "^0.16.1",
+    "rimraf": "^6.0.1",
+    "tsx": "^4.7.0",
+    "typescript": "^5.7.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}