@drqedwards/pmll 2.0.4

package/dist/graphql.js

@@ -0,0 +1,389 @@
+/**
+ * graphql.ts — GraphQL execution helper for the PMLL Memory MCP Server.
+ *
+ * Provides:
+ *   1. Pre-built GraphQL operation documents (`GRAPHQL_QUERY`, `GRAPHQL_MUTATION`)
+ *      that define the full query/mutation API surface.
+ *   2. `executeGraphQL()` — a lightweight fetch-based executor that POSTs
+ *      an operation to a GraphQL endpoint and returns the parsed response.
+ *
+ * The pre-built operations cover the complete API surface:
+ *   Query  — interviewTemplate, company, companyTestSession, roles, tasks, etc.
+ *   Mutation — CRUD for interview templates, test sessions, roles, tasks, etc.
+ *
+ * **Note on selection sets:** The pre-built operations use empty selection
+ * sets (`{ }`) as placeholders.  These serve as canonical templates that
+ * document the available fields and their required variable signatures.
+ * Agents should supply a custom `operation` string with the fields they
+ * actually need when executing against a real endpoint.
+ *
+ * **Note on required variables:** All variables in the pre-built operations
+ * are declared as required (`!`), matching the API specification.  The
+ * `GRAPHQL_DEFAULT_VARIABLES` constant provides an all-null baseline; callers
+ * must override every variable that the server treats as non-nullable before
+ * executing the operation.
+ *
+ * These constants are available for agents/tools that need a canonical
+ * reference to the full operation shape, while `executeGraphQL` is used
+ * by the `graphql` MCP tool to execute arbitrary or pre-built operations.
+ */
+// ---------------------------------------------------------------------------
+// Pre-built operation documents
+// ---------------------------------------------------------------------------
+/**
+ * Canonical Query operation document.
+ *
+ * Covers every top-level query field in the API.  Variables are typed so
+ * callers can supply a subset and leave the rest undefined/null.
+ *
+ * Selection sets are intentionally empty (`{ }`) — this document is a
+ * template/reference.  Provide a custom `operation` string with real
+ * field selections when executing against a live endpoint.
+ */
+export const GRAPHQL_QUERY = `query Query($interviewTemplateId: ID!, $first: Int!, $offset: Int!, $frameworksFirst2: Int!, $atsCompanyTestSessionsId: String!, $idType: AtsIdType!, $companyTestSessionId: ID!, $companyTestId: ID!, $standardizedTestSessionId: ID!, $key: ID!, $companyTestId2: ID!, $companyTestsFirst2: Int!, $certificationTestsFirst2: Int!, $standardizedTestId: ID!, $liveInterviewId: ID!, $type: AccessType!, $accessQueries: [AccessQueryInput!]!, $taskSetsFirst2: Int!, $testLabelsFirst2: Int!, $aiInterviewersFirst2: Int!, $llmModelCategoriesFirst2: Int!, $taskLevelId: ID!, $taskId: ID!, $name: String!) {
+  interviewTemplate(interviewTemplateId: $interviewTemplateId) {
+    
+  }
+  interviewTemplates(first: $first, offset: $offset) {
+    
+  }
+  company {
+    
+  }
+  companies {
+    
+  }
+  servicePlans {
+    
+  }
+  frameworks(first: $frameworksFirst2) {
+    
+  }
+  atsCompanyTestSessions(id: $atsCompanyTestSessionsId, idType: $idType) {
+    
+  }
+  companyTestSession(id: $companyTestSessionId) {
+    
+  }
+  companyTestSessions(companyTestId: $companyTestId) {
+    
+  }
+  standardizedTestSession(id: $standardizedTestSessionId) {
+    
+  }
+  companyRoles {
+    
+  }
+  systemRoles {
+    
+  }
+  role(key: $key) {
+    
+  }
+  companyTest(id: $companyTestId2) {
+    
+  }
+  companyTests(first: $companyTestsFirst2) {
+    
+  }
+  certificationTests(first: $certificationTestsFirst2) {
+    
+  }
+  standardizedTest(id: $standardizedTestId) {
+    
+  }
+  liveInterview(liveInterviewId: $liveInterviewId) {
+    
+  }
+  liveInterviews {
+    
+  }
+  hasAccess(type: $type)
+  hasAccessList(accessQueries: $accessQueries) {
+    
+  }
+  taskSets(first: $taskSetsFirst2) {
+    
+  }
+  testLabels(first: $testLabelsFirst2) {
+    
+  }
+  user {
+    
+  }
+  aiInterviewers(first: $aiInterviewersFirst2) {
+    
+  }
+  llmModelCategories(first: $llmModelCategoriesFirst2) {
+    
+  }
+  taskLevel(taskLevelId: $taskLevelId) {
+    
+  }
+  task(id: $taskId) {
+    
+  }
+  codesignalCreatedTasks(name: $name) {
+    
+  }
+}`;
+/**
+ * Canonical Mutation operation document.
+ *
+ * Covers every top-level mutation field in the API.  Variables are typed
+ * and namespaced to avoid conflicts when multiple mutations share the same
+ * logical parameter name.
+ *
+ * Selection sets are intentionally empty (`{ }`) — this document is a
+ * template/reference.  Provide a custom `operation` string with real
+ * field selections when executing against a live endpoint.
+ */
+export const GRAPHQL_MUTATION = `mutation Mutation($deleteInterviewTemplateInterviewTemplateId2: ID!, $interviewTemplateFields: CreateInterviewTemplateInput!, $editInterviewTemplateInterviewTemplateId2: ID!, $editInterviewTemplateInterviewTemplateFields2: EditInterviewTemplateInput!, $companyId: ID!, $lockdownFrameworkEnabled: Boolean!, $editCompanyPlanSettingsCompanyId2: ID!, $planSettings: CompanyPlanSettingsInput!, $appendCompanyTestSessionVerificationNoteId: ID!, $note: String!, $sessionFields: TestSessionInput!, $deleteCompanyTestSessionId: ID!, $editCompanyTestSessionDurationId: ID!, $customDuration: Float!, $editCompanyTestSessionExpirationId: ID!, $expirationDate: Timestamp!, $setCompanyTestSessionRemindersId: ID!, $reminders: [EmailReminder!]!, $resendCompanyTestSessionId: ID!, $reactivateCompanyTestSessionId: ID!, $gradeCompanyTestResultId: ID!, $gradeCompanyTestResultTaskId2: ID!, $score: Int!, $markCompanyTestResultAsGradedId: ID!, $archiveCompanyTestSessionId: ID!, $unarchiveCompanyTestSessionId: ID!, $saveRoleKey2: ID!, $title: String!, $permissions: [String!]!, $createCompanyRoleTitle2: String!, $createCompanyRolePermissions2: [String!]!, $editCompanyRoleKey2: ID!, $editCompanyRoleTitle2: String!, $editCompanyRolePermissions2: [String!]!, $deleteRoleKey2: ID!, $testFields: CreateCompanyTestInput!, $createCompanyTestFromFrameworkTestFields2: CreateCompanyTestFromFrameworkInput!, $editCompanyTestId: ID!, $editCompanyTestTestFields2: EditCompanyTestInput!, $duplicateCompanyTestId: ID!, $duplicateCompanyTestTestFields2: EditCompanyTestInput!, $editLiveInterviewId: ID!, $interviewFields: LiveInterviewInput!, $deleteLiveInterviewId: ID!, $editTaskSetsInput: EditTaskSetsInput!, $removeTaskFromSetsEditTaskSetsInput2: EditTaskSetsInput!, $setTaskInitialSourceId: ID!, $language: LanguageName!, $source: String!, $unsetTaskInitialSourceId: ID!, $unsetTaskInitialSourceLanguage2: LanguageName!, $taskFields: CreateCodeReviewTaskInput!, $editCodeReviewTaskId: ID!, $editCodeReviewTaskTaskFields2: EditCodeReviewTaskInput!, $createDatabaseTaskTaskFields2: CreateDatabaseTaskInput!, $editDatabaseTaskId: ID!, $editDatabaseTaskTaskFields2: EditDatabaseTaskInput!, $createFreeCodingTaskTaskFields2: CreateFreeCodingTaskInput!, $editFreeCodingTaskId: ID!, $editFreeCodingTaskTaskFields2: EditStandardTaskInput!, $updateFrontendTaskId: ID!, $patch: UpdateFrontendTaskInput!, $createQuizTaskTaskFields2: CreateQuizInput!, $editQuizTaskId: ID!, $editQuizTaskTaskFields2: EditQuizInput!, $createStandardTaskTaskFields2: CreateStandardTaskInput!, $editStandardTaskId: ID!, $editStandardTaskTaskFields2: EditStandardTaskInput!) {
+  deleteInterviewTemplate(interviewTemplateId: $deleteInterviewTemplateInterviewTemplateId2)
+  createInterviewTemplate(interviewTemplateFields: $interviewTemplateFields) {
+    
+  }
+  editInterviewTemplate(interviewTemplateId: $editInterviewTemplateInterviewTemplateId2, interviewTemplateFields: $editInterviewTemplateInterviewTemplateFields2) {
+    
+  }
+  updateLockdownFrameworkEnabled(companyId: $companyId, lockdownFrameworkEnabled: $lockdownFrameworkEnabled) {
+    
+  }
+  editCompanyPlanSettings(companyId: $editCompanyPlanSettingsCompanyId2, planSettings: $planSettings) {
+    
+  }
+  appendCompanyTestSessionVerificationNote(id: $appendCompanyTestSessionVerificationNoteId, note: $note) {
+    
+  }
+  createCompanyTestSession(sessionFields: $sessionFields) {
+    
+  }
+  deleteCompanyTestSession(id: $deleteCompanyTestSessionId)
+  editCompanyTestSessionDuration(id: $editCompanyTestSessionDurationId, customDuration: $customDuration) {
+    
+  }
+  editCompanyTestSessionExpiration(id: $editCompanyTestSessionExpirationId, expirationDate: $expirationDate) {
+    
+  }
+  setCompanyTestSessionReminders(id: $setCompanyTestSessionRemindersId, reminders: $reminders) {
+    
+  }
+  resendCompanyTestSession(id: $resendCompanyTestSessionId) {
+    
+  }
+  reactivateCompanyTestSession(id: $reactivateCompanyTestSessionId) {
+    
+  }
+  gradeCompanyTestResult(id: $gradeCompanyTestResultId, taskId: $gradeCompanyTestResultTaskId2, score: $score) {
+    
+  }
+  markCompanyTestResultAsGraded(id: $markCompanyTestResultAsGradedId) {
+    
+  }
+  archiveCompanyTestSession(id: $archiveCompanyTestSessionId) {
+    
+  }
+  unarchiveCompanyTestSession(id: $unarchiveCompanyTestSessionId) {
+    
+  }
+  saveRole(key: $saveRoleKey2, title: $title, permissions: $permissions) {
+    
+  }
+  createCompanyRole(title: $createCompanyRoleTitle2, permissions: $createCompanyRolePermissions2) {
+    
+  }
+  editCompanyRole(key: $editCompanyRoleKey2, title: $editCompanyRoleTitle2, permissions: $editCompanyRolePermissions2) {
+    
+  }
+  deleteRole(key: $deleteRoleKey2)
+  createCompanyTest(testFields: $testFields) {
+    
+  }
+  createCompanyTestFromFramework(testFields: $createCompanyTestFromFrameworkTestFields2) {
+    
+  }
+  editCompanyTest(id: $editCompanyTestId, testFields: $editCompanyTestTestFields2) {
+    
+  }
+  duplicateCompanyTest(id: $duplicateCompanyTestId, testFields: $duplicateCompanyTestTestFields2) {
+    
+  }
+  createLiveInterview {
+    
+  }
+  editLiveInterview(id: $editLiveInterviewId, interviewFields: $interviewFields) {
+    
+  }
+  deleteLiveInterview(id: $deleteLiveInterviewId)
+  addTaskToSets(editTaskSetsInput: $editTaskSetsInput) {
+    
+  }
+  removeTaskFromSets(editTaskSetsInput: $removeTaskFromSetsEditTaskSetsInput2) {
+    
+  }
+  setTaskInitialSource(id: $setTaskInitialSourceId, language: $language, source: $source) {
+    
+  }
+  unsetTaskInitialSource(id: $unsetTaskInitialSourceId, language: $unsetTaskInitialSourceLanguage2) {
+    
+  }
+  createCodeReviewTask(taskFields: $taskFields) {
+    
+  }
+  editCodeReviewTask(id: $editCodeReviewTaskId, taskFields: $editCodeReviewTaskTaskFields2) {
+    
+  }
+  createDatabaseTask(taskFields: $createDatabaseTaskTaskFields2) {
+    
+  }
+  editDatabaseTask(id: $editDatabaseTaskId, taskFields: $editDatabaseTaskTaskFields2) {
+    
+  }
+  createFreeCodingTask(taskFields: $createFreeCodingTaskTaskFields2) {
+    
+  }
+  editFreeCodingTask(id: $editFreeCodingTaskId, taskFields: $editFreeCodingTaskTaskFields2) {
+    
+  }
+  updateFrontendTask(id: $updateFrontendTaskId, patch: $patch) {
+    
+  }
+  createQuizTask(taskFields: $createQuizTaskTaskFields2) {
+    
+  }
+  editQuizTask(id: $editQuizTaskId, taskFields: $editQuizTaskTaskFields2) {
+    
+  }
+  createStandardTask(taskFields: $createStandardTaskTaskFields2) {
+    
+  }
+  editStandardTask(id: $editStandardTaskId, taskFields: $editStandardTaskTaskFields2) {
+    
+  }
+}`;
+/**
+ * Default variables object for the pre-built operations.
+ *
+ * All values are null; callers supply only the variables relevant to their
+ * specific sub-operation.
+ */
+export const GRAPHQL_DEFAULT_VARIABLES = {
+    first: null,
+    offset: null,
+    appendCompanyTestSessionVerificationNoteId: null,
+    note: null,
+    interviewTemplateId: null,
+    frameworksFirst2: null,
+    atsCompanyTestSessionsId: null,
+    idType: null,
+    companyTestSessionId: null,
+    companyTestId: null,
+    standardizedTestSessionId: null,
+    key: null,
+    companyTestId2: null,
+    companyTestsFirst2: null,
+    certificationTestsFirst2: null,
+    standardizedTestId: null,
+    liveInterviewId: null,
+    type: null,
+    accessQueries: null,
+    taskSetsFirst2: null,
+    testLabelsFirst2: null,
+    aiInterviewersFirst2: null,
+    llmModelCategoriesFirst2: null,
+    taskLevelId: null,
+    taskId: null,
+    name: null,
+    deleteInterviewTemplateInterviewTemplateId2: null,
+    interviewTemplateFields: null,
+    editInterviewTemplateInterviewTemplateId2: null,
+    editInterviewTemplateInterviewTemplateFields2: null,
+    companyId: null,
+    lockdownFrameworkEnabled: null,
+    editCompanyPlanSettingsCompanyId2: null,
+    planSettings: null,
+    sessionFields: null,
+    deleteCompanyTestSessionId: null,
+    editCompanyTestSessionDurationId: null,
+    customDuration: null,
+    editCompanyTestSessionExpirationId: null,
+    expirationDate: null,
+    setCompanyTestSessionRemindersId: null,
+    reminders: null,
+    resendCompanyTestSessionId: null,
+    reactivateCompanyTestSessionId: null,
+    gradeCompanyTestResultId: null,
+    gradeCompanyTestResultTaskId2: null,
+    score: null,
+    markCompanyTestResultAsGradedId: null,
+    archiveCompanyTestSessionId: null,
+    unarchiveCompanyTestSessionId: null,
+    saveRoleKey2: null,
+    title: null,
+    permissions: null,
+    createCompanyRoleTitle2: null,
+    createCompanyRolePermissions2: null,
+    editCompanyRoleKey2: null,
+    editCompanyRoleTitle2: null,
+    editCompanyRolePermissions2: null,
+    deleteRoleKey2: null,
+    testFields: null,
+    createCompanyTestFromFrameworkTestFields2: null,
+    editCompanyTestId: null,
+    editCompanyTestTestFields2: null,
+    duplicateCompanyTestId: null,
+    duplicateCompanyTestTestFields2: null,
+    editLiveInterviewId: null,
+    interviewFields: null,
+    deleteLiveInterviewId: null,
+    editTaskSetsInput: null,
+    removeTaskFromSetsEditTaskSetsInput2: null,
+    setTaskInitialSourceId: null,
+    language: null,
+    source: null,
+    unsetTaskInitialSourceId: null,
+    unsetTaskInitialSourceLanguage2: null,
+    taskFields: null,
+    editCodeReviewTaskId: null,
+    editCodeReviewTaskTaskFields2: null,
+    createDatabaseTaskTaskFields2: null,
+    editDatabaseTaskId: null,
+    editDatabaseTaskTaskFields2: null,
+    createFreeCodingTaskTaskFields2: null,
+    editFreeCodingTaskId: null,
+    editFreeCodingTaskTaskFields2: null,
+    updateFrontendTaskId: null,
+    patch: null,
+    createQuizTaskTaskFields2: null,
+    editQuizTaskId: null,
+    editQuizTaskTaskFields2: null,
+    createStandardTaskTaskFields2: null,
+    editStandardTaskId: null,
+    editStandardTaskTaskFields2: null,
+};
+/**
+ * Execute a GraphQL operation against `endpoint` via HTTP POST.
+ *
+ * Uses the built-in `fetch` API (Node.js 18+).  Returns the parsed JSON
+ * response body.  Throws on HTTP-level errors (non-2xx status).
+ *
+ * @param endpoint   Full URL of the GraphQL endpoint.
+ * @param operation  GraphQL operation document (query or mutation string).
+ * @param variables  Variables to pass with the operation.
+ * @param headers    Additional HTTP headers (e.g. Authorization).
+ */
+export async function executeGraphQL(endpoint, operation, variables = {}, headers = {}) {
+    const response = await fetch(endpoint, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            ...headers,
+        },
+        body: JSON.stringify({ query: operation, variables }),
+    });
+    if (!response.ok) {
+        throw new Error(`GraphQL HTTP error: ${response.status} ${response.statusText}`);
+    }
+    return response.json();
+}
+//# sourceMappingURL=graphql.js.map

package/dist/graphql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql.js","sourceRoot":"","sources":["../src/graphql.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+/**
+ * index.ts — PMLL Memory MCP Server entrypoint.
+ *
+ * Exposes 15 MCP tools for Claude Sonnet/Opus agents:
+ *
+ * Short-term KV memory (5 tools):
+ *   init    — Set up the PMLL memory silo and Q-promise chain for a session.
+ *   peek    — Non-destructive context check (core deduplication primitive).
+ *   set     — Store a KV pair in the session's PMLL silo.
+ *   resolve — Resolve a pending Q-promise continuation.
+ *   flush   — Clear all short-term KV slots at agent task completion.
+ *
+ * GraphQL (1 tool):
+ *   graphql — Execute GraphQL queries/mutations against the memory store.
+ *
+ * Long-term memory graph (6 tools — adapted from Context+ by @ForLoopCodes):
+ *   upsert_memory_node      — Create/update memory nodes with TF-IDF embeddings.
+ *   create_relation          — Create typed edges between nodes.
+ *   search_memory_graph      — Semantic search with graph traversal.
+ *   prune_stale_links        — Remove decayed edges and orphan nodes.
+ *   add_interlinked_context  — Bulk-add nodes with auto-similarity linking.
+ *   retrieve_with_traversal  — Walk outward from a node.
+ *
+ * Solution engine (3 tools):
+ *   resolve_context      — Unified short-term → long-term context lookup.
+ *   promote_to_long_term — Promote KV entries to the memory graph.
+ *   memory_status        — Unified memory view across both layers.
+ *
+ * The server is designed as the **3rd initializer** alongside Playwright and
+ * other MCP tools.  Agents call `init` once at task start, then use
+ * `peek` before any expensive MCP tool invocation to avoid redundant calls.
+ *
+ * Context+ integration by @ForLoopCodes (https://github.com/ForLoopCodes/contextplus).
+ *
+ * Architecture:
+ *     - KV layer  → `PMMemoryStore` (mirrors PMLL.c memory_silo_t)
+ *     - Async layer → `QPromiseRegistry` (mirrors Q_promise_lib QMemNode chain)
+ *     - Guard function → `peekContext()` (peek.ts)
+ *     - Long-term → `memory-graph.ts` (adapted from Context+)
+ *     - Engine → `solution-engine.ts` (bridges short-term + long-term)
+ *
+ * Usage:
+ *     npx pmll-memory-mcp                        # stdio transport
+ *     node dist/index.js                         # via compiled output
+ *
+ * License: MIT
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { QPromiseRegistry } from "./q-promise-bridge.js";
+declare const server: McpServer;
+export declare const _promiseRegistry: QPromiseRegistry;
+export declare const _activeSessions: Map<string, number>;
+export { server };
+//# 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":";AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAoBzD,QAAA,MAAM,MAAM,WAkBX,CAAC;AAIF,eAAO,MAAM,gBAAgB,kBAAyB,CAAC;AAGvD,eAAO,MAAM,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAa,CAAC;AAorB9D,OAAO,EAAE,MAAM,EAAE,CAAC"}