@schoolai/shipyard-mcp 0.1.0

package/apps/server/dist/chunk-SIQIBECG.js

@@ -0,0 +1,273 @@
+import {
+  InputRequestSchema,
+  YDOC_KEYS,
+  createInputRequest,
+  logPlanEvent
+} from "./chunk-LTC26IRQ.js";
+import {
+  logger
+} from "./chunk-GSGLHRWX.js";
+
+// src/services/input-request-manager.ts
+var InputRequestManager = class {
+  /**
+   * Create a new input request in the Y.Doc.
+   * Request is added to the INPUT_REQUESTS array and becomes visible in browser UI.
+   *
+   * @param ydoc - The Y.Doc to add the request to
+   * @param params - Request parameters (message, type, options, etc.)
+   * @returns The generated request ID
+   */
+  createRequest(ydoc, params) {
+    const request = createInputRequest(params);
+    ydoc.transact(() => {
+      const requestsArray = ydoc.getArray(YDOC_KEYS.INPUT_REQUESTS);
+      requestsArray.push([request]);
+      logPlanEvent(ydoc, "input_request_created", "Agent", {
+        requestId: request.id,
+        requestType: request.type,
+        requestMessage: request.message
+      });
+    });
+    logger.info(
+      { requestId: request.id, type: request.type, timeout: request.timeout },
+      "Created input request in Y.Doc"
+    );
+    return request.id;
+  }
+  /**
+   * Wait for a user to respond to an input request.
+   * Blocks until the request is answered, cancelled, or times out.
+   *
+   * Pattern: Based on waitForReviewDecision from review-status.ts
+   * - Observes Y.Doc changes via Y.Array observer
+   * - Polls for status changes to the specific request
+   * - Unsubscribes and cleans up on completion
+   *
+   * @param ydoc - The Y.Doc containing the request
+   * @param requestId - The ID of the request to wait for
+   * @param timeoutSeconds - Max time to wait (0 = no timeout, uses request.timeout if not specified)
+   * @returns Promise that resolves when request is answered/cancelled
+   */
+  async waitForResponse(ydoc, requestId, timeoutSeconds) {
+    return new Promise((resolve) => {
+      const requestsArray = ydoc.getArray(YDOC_KEYS.INPUT_REQUESTS);
+      let resolved = false;
+      let timeoutHandle;
+      let observerFn;
+      const findRequest = () => {
+        const requests = requestsArray.toJSON();
+        return requests.find((r) => r.id === requestId);
+      };
+      const cleanup = () => {
+        if (observerFn) {
+          requestsArray.unobserve(observerFn);
+          observerFn = void 0;
+        }
+        if (timeoutHandle) {
+          clearTimeout(timeoutHandle);
+          timeoutHandle = void 0;
+        }
+        if (!resolved) {
+          resolved = true;
+        }
+      };
+      const checkStatus = () => {
+        if (resolved) return;
+        const request2 = findRequest();
+        if (!request2) {
+          handleRequestNotFound();
+          return;
+        }
+        logger.debug({ requestId, status: request2.status }, "Checking input request status");
+        if (request2.status === "answered") {
+          handleAnsweredStatus(request2);
+        } else if (request2.status === "declined") {
+          handleDeclinedStatus();
+        } else if (request2.status === "cancelled") {
+          handleCancelledStatus();
+        }
+      };
+      const handleRequestNotFound = () => {
+        logger.warn({ requestId }, "Request not found, treating as cancelled");
+        resolved = true;
+        cleanup();
+        resolve({
+          success: false,
+          status: "cancelled",
+          reason: "Request not found in Y.Doc"
+        });
+      };
+      const handleAnsweredStatus = (request2) => {
+        logger.info({ requestId, answeredBy: request2.answeredBy }, "Input request answered");
+        resolved = true;
+        cleanup();
+        resolve({
+          success: true,
+          response: request2.response,
+          status: "answered",
+          answeredBy: request2.answeredBy ?? "unknown",
+          answeredAt: request2.answeredAt ?? Date.now()
+        });
+      };
+      const handleDeclinedStatus = () => {
+        logger.info({ requestId }, "Input request declined by user");
+        resolved = true;
+        cleanup();
+        resolve({
+          success: true,
+          status: "declined",
+          reason: "User declined to answer"
+        });
+      };
+      const handleCancelledStatus = () => {
+        logger.info({ requestId }, "Input request cancelled (timeout)");
+        resolved = true;
+        cleanup();
+        resolve({
+          success: false,
+          status: "cancelled",
+          reason: "Request timed out"
+        });
+      };
+      observerFn = () => {
+        checkStatus();
+      };
+      checkStatus();
+      if (resolved) {
+        return;
+      }
+      requestsArray.observe(observerFn);
+      const request = findRequest();
+      const effectiveTimeout = timeoutSeconds !== void 0 ? timeoutSeconds : request?.timeout !== void 0 ? request.timeout : 0;
+      const handleTimeout = () => {
+        if (resolved) return;
+        logger.warn({ requestId, timeout: effectiveTimeout }, "Input request timed out");
+        markRequestAsCancelled();
+        if (resolved) return;
+        resolved = true;
+        cleanup();
+        const minutes = Math.floor(effectiveTimeout / 60);
+        const seconds = effectiveTimeout % 60;
+        const timeStr = minutes > 0 ? `${minutes} minute${minutes === 1 ? "" : "s"}${seconds > 0 ? ` ${seconds} second${seconds === 1 ? "" : "s"}` : ""}` : `${seconds} second${seconds === 1 ? "" : "s"}`;
+        resolve({
+          success: false,
+          status: "cancelled",
+          reason: `Request timed out after ${timeStr}. The user likely didn't see the request in time. Please try again.`
+        });
+      };
+      const markRequestAsCancelled = () => {
+        ydoc.transact(() => {
+          if (resolved) return;
+          const currentRequest = findRequest();
+          if (!currentRequest || currentRequest.status !== "pending") {
+            return;
+          }
+          const requests = requestsArray.toJSON();
+          const index = requests.findIndex((r) => r.id === requestId);
+          if (index !== -1) {
+            requestsArray.delete(index, 1);
+            requestsArray.insert(index, [{ ...currentRequest, status: "cancelled" }]);
+          }
+        });
+      };
+      if (effectiveTimeout > 0) {
+        timeoutHandle = setTimeout(handleTimeout, effectiveTimeout * 1e3);
+      }
+    });
+  }
+  /**
+   * Cancel a pending input request.
+   * Marks the request as cancelled in the Y.Doc.
+   *
+   * @param ydoc - The Y.Doc containing the request
+   * @param requestId - The ID of the request to cancel
+   * @returns True if request was found and cancelled, false otherwise
+   */
+  cancelRequest(ydoc, requestId) {
+    let cancelled = false;
+    ydoc.transact(() => {
+      const requestsArray = ydoc.getArray(YDOC_KEYS.INPUT_REQUESTS);
+      const requests = requestsArray.toJSON();
+      const index = requests.findIndex((r) => r.id === requestId);
+      if (index !== -1) {
+        const request = requests[index];
+        if (request.status === "pending") {
+          requestsArray.delete(index, 1);
+          requestsArray.insert(index, [{ ...request, status: "cancelled" }]);
+          cancelled = true;
+          logger.info({ requestId }, "Cancelled input request");
+        } else {
+          logger.debug({ requestId, status: request.status }, "Request not pending, cannot cancel");
+        }
+      } else {
+        logger.warn({ requestId }, "Request not found for cancellation");
+      }
+    });
+    return cancelled;
+  }
+  /**
+   * Get the current state of an input request.
+   * Returns undefined if the request doesn't exist.
+   *
+   * @param ydoc - The Y.Doc containing the request
+   * @param requestId - The ID of the request to retrieve
+   * @returns The request object, or undefined if not found
+   */
+  getRequest(ydoc, requestId) {
+    const requestsArray = ydoc.getArray(YDOC_KEYS.INPUT_REQUESTS);
+    const requests = requestsArray.toJSON();
+    const request = requests.find((r) => r.id === requestId);
+    if (request) {
+      const parseResult = InputRequestSchema.safeParse(request);
+      if (parseResult.success) {
+        return parseResult.data;
+      }
+      logger.warn({ requestId, error: parseResult.error }, "Invalid request data in Y.Doc");
+    }
+    return void 0;
+  }
+  /**
+   * Get all pending input requests for a Y.Doc.
+   * Useful for UI to display all active requests.
+   *
+   * @param ydoc - The Y.Doc to query
+   * @returns Array of pending requests
+   */
+  getPendingRequests(ydoc) {
+    const requestsArray = ydoc.getArray(YDOC_KEYS.INPUT_REQUESTS);
+    const requests = requestsArray.toJSON();
+    return requests.filter((r) => r.status === "pending");
+  }
+  /**
+   * Clean up old completed/cancelled requests from Y.Doc.
+   * Removes requests older than the specified age to prevent unbounded growth.
+   *
+   * @param ydoc - The Y.Doc to clean up
+   * @param maxAgeMs - Maximum age in milliseconds (default: 24 hours)
+   * @returns Number of requests removed
+   */
+  cleanupOldRequests(ydoc, maxAgeMs = 24 * 60 * 60 * 1e3) {
+    let removed = 0;
+    const cutoff = Date.now() - maxAgeMs;
+    ydoc.transact(() => {
+      const requestsArray = ydoc.getArray(YDOC_KEYS.INPUT_REQUESTS);
+      const requests = requestsArray.toJSON();
+      for (let i = requests.length - 1; i >= 0; i--) {
+        const request = requests[i];
+        if (request.status !== "pending" && (request.answeredAt ?? request.createdAt) < cutoff) {
+          requestsArray.delete(i, 1);
+          removed++;
+        }
+      }
+    });
+    if (removed > 0) {
+      logger.info({ removed, maxAgeMs }, "Cleaned up old input requests");
+    }
+    return removed;
+  }
+};
+
+export {
+  InputRequestManager
+};

package/apps/server/dist/dist-LQBXUHLR.js

@@ -0,0 +1,409 @@
+import {
+  A2ADataPartSchema,
+  A2AFilePartSchema,
+  A2AMessageSchema,
+  A2APartSchema,
+  A2ATextPartSchema,
+  AgentActivityDataSchema,
+  AgentActivityTypes,
+  AgentPresenceSchema,
+  ArtifactSchema,
+  ChangeSchema,
+  ChangeTypeSchema,
+  ChangesResponseSchema,
+  ChunkMessageSchema,
+  ClaudeCodeMessageSchema,
+  ClaudeCodeOriginMetadataSchema,
+  ConversationExportEndSchema,
+  ConversationExportMetaSchema,
+  ConversationExportStartMetaSchema,
+  ConversationVersionSchema,
+  CreateHookSessionRequestSchema,
+  CreateHookSessionResponseSchema,
+  CreateSubscriptionRequestSchema,
+  CreateSubscriptionResponseSchema,
+  CursorOriginMetadataSchema,
+  DeleteSubscriptionResponseSchema,
+  DeliverableSchema,
+  DevinOriginMetadataSchema,
+  GetReviewStatusResponseSchema,
+  GitHubPRResponseSchema,
+  HasConnectionsResponseSchema,
+  HookApiErrorSchema,
+  ImportConversationRequestSchema,
+  ImportConversationResponseSchema,
+  InputRequestSchema,
+  InputRequestStatusValues,
+  InputRequestTypeValues,
+  InviteRedemptionSchema,
+  InviteTokenSchema,
+  LinkedPRSchema,
+  LinkedPRStatusValues,
+  NON_PLAN_DB_NAMES,
+  OriginMetadataSchema,
+  OriginPlatformValues,
+  P2PMessageType,
+  PLAN_INDEX_DOC_NAME,
+  PLAN_INDEX_EVENT_VIEWED_BY_KEY,
+  PLAN_INDEX_VIEWED_BY_KEY,
+  PRReviewCommentSchema,
+  PlanEventSchema,
+  PlanEventTypes,
+  PlanIdSchema,
+  PlanIndexEntrySchema,
+  PlanMetadataSchema,
+  PlanSnapshotSchema,
+  PlanStatusResponseSchema,
+  PlanStatusValues,
+  PlanViewTabValues,
+  ROUTES,
+  RegisterServerRequestSchema,
+  RegisterServerResponseSchema,
+  ReviewCommentSchema,
+  ReviewFeedbackSchema,
+  SetSessionTokenRequestSchema,
+  SetSessionTokenResponseSchema,
+  SubscriptionClientIdSchema,
+  ThreadCommentSchema,
+  ThreadSchema,
+  UnregisterServerRequestSchema,
+  UnregisterServerResponseSchema,
+  UpdatePlanContentRequestSchema,
+  UpdatePlanContentResponseSchema,
+  UpdatePresenceRequestSchema,
+  UpdatePresenceResponseSchema,
+  VALID_STATUS_TRANSITIONS,
+  YDOC_KEYS,
+  a2aToClaudeCode,
+  addArtifact,
+  addConversationVersion,
+  addDeliverable,
+  addPRReviewComment,
+  addPlanTag,
+  addSnapshot,
+  answerInputRequest,
+  appRouter,
+  approveUser,
+  archivePlan,
+  asAwarenessClientId,
+  asGitHubUsername,
+  asPlanId,
+  asWebRTCPeerId,
+  assertNever,
+  assertNeverP2PMessage,
+  buildInviteUrl,
+  cancelInputRequest,
+  claudeCodeToA2A,
+  clearAgentPresence,
+  clearEventViewedBy,
+  clearPlanIndexViewedBy,
+  conversationRouter,
+  createGitHubArtifact,
+  createHandedOffConversationVersion,
+  createInitialConversationVersion,
+  createInputRequest,
+  createLinkedPR,
+  createLocalArtifact,
+  createPlanSnapshot,
+  createPlanUrl,
+  createPlanUrlWithHistory,
+  createUserResolver,
+  decodeChunkMessage,
+  decodeExportEndMessage,
+  decodeExportStartMessage,
+  decodeP2PMessage,
+  decodePlan,
+  encodeChunkMessage,
+  encodeExportEndMessage,
+  encodeExportStartMessage,
+  encodePlan,
+  extractDeliverables,
+  extractMentions,
+  extractTextFromCommentBody,
+  formatAsClaudeCodeJSONL,
+  formatDeliverablesForLLM,
+  formatThreadsForLLM,
+  getAgentPresence,
+  getAgentPresences,
+  getAllEventViewedByForPlan,
+  getAllTagsFromIndex,
+  getAllViewedByFromIndex,
+  getApprovedUsers,
+  getArtifactUrl,
+  getArtifacts,
+  getConversationVersions,
+  getDeliverables,
+  getLatestSnapshot,
+  getLinkedPR,
+  getLinkedPRs,
+  getPRReviewComments,
+  getPRReviewCommentsForPR,
+  getPlanEvents,
+  getPlanFromUrl,
+  getPlanIndex,
+  getPlanIndexEntry,
+  getPlanMetadata,
+  getPlanMetadataWithValidation,
+  getPlanOwnerId,
+  getRejectedUsers,
+  getSnapshots,
+  getStepCompletions,
+  getTokenTimeRemaining,
+  getViewedBy,
+  getViewedByFromIndex,
+  hookRouter,
+  initPlanMetadata,
+  isApprovalRequired,
+  isConversationChunk,
+  isConversationExportEnd,
+  isConversationExportStart,
+  isEventUnread,
+  isInboxWorthy,
+  isP2PConversationMessage,
+  isPlanUnread,
+  isStepCompleted,
+  isThread,
+  isUrlEncodedPlanV1,
+  isUrlEncodedPlanV2,
+  isUserApproved,
+  isUserRejected,
+  isValidYDocKey,
+  linkArtifactToDeliverable,
+  linkPR,
+  logPlanEvent,
+  markEventAsViewed,
+  markPlanAsViewed,
+  markVersionHandedOff,
+  parseClaudeCodeOrigin,
+  parseClaudeCodeTranscriptString,
+  parseInviteFromUrl,
+  parseThreads,
+  planRouter,
+  rejectUser,
+  removeArtifact,
+  removePRReviewComment,
+  removePlanIndexEntry,
+  removePlanTag,
+  removeViewedByFromIndex,
+  resolvePRReviewComment,
+  revokeUser,
+  setAgentPresence,
+  setPlanIndexEntry,
+  setPlanMetadata,
+  subscriptionRouter,
+  summarizeA2AConversation,
+  toggleStepCompletion,
+  touchPlanIndexEntry,
+  transitionPlanStatus,
+  unarchivePlan,
+  unlinkPR,
+  unrejectUser,
+  updateLinkedPRStatus,
+  updatePlanIndexViewedBy,
+  validateA2AMessages
+} from "./chunk-LTC26IRQ.js";
+import "./chunk-JSBRDJBE.js";
+export {
+  A2ADataPartSchema,
+  A2AFilePartSchema,
+  A2AMessageSchema,
+  A2APartSchema,
+  A2ATextPartSchema,
+  AgentActivityDataSchema,
+  AgentActivityTypes,
+  AgentPresenceSchema,
+  ArtifactSchema,
+  ChangeSchema,
+  ChangeTypeSchema,
+  ChangesResponseSchema,
+  ChunkMessageSchema,
+  ClaudeCodeMessageSchema,
+  ClaudeCodeOriginMetadataSchema,
+  ConversationExportEndSchema,
+  ConversationExportMetaSchema,
+  ConversationExportStartMetaSchema,
+  ConversationVersionSchema,
+  CreateHookSessionRequestSchema,
+  CreateHookSessionResponseSchema,
+  CreateSubscriptionRequestSchema,
+  CreateSubscriptionResponseSchema,
+  CursorOriginMetadataSchema,
+  DeleteSubscriptionResponseSchema,
+  DeliverableSchema,
+  DevinOriginMetadataSchema,
+  GetReviewStatusResponseSchema,
+  GitHubPRResponseSchema,
+  HasConnectionsResponseSchema,
+  HookApiErrorSchema,
+  ImportConversationRequestSchema,
+  ImportConversationResponseSchema,
+  InputRequestSchema,
+  InputRequestStatusValues,
+  InputRequestTypeValues,
+  InviteRedemptionSchema,
+  InviteTokenSchema,
+  LinkedPRSchema,
+  LinkedPRStatusValues,
+  NON_PLAN_DB_NAMES,
+  OriginMetadataSchema,
+  OriginPlatformValues,
+  P2PMessageType,
+  PLAN_INDEX_DOC_NAME,
+  PLAN_INDEX_EVENT_VIEWED_BY_KEY,
+  PLAN_INDEX_VIEWED_BY_KEY,
+  PRReviewCommentSchema,
+  PlanEventSchema,
+  PlanEventTypes,
+  PlanIdSchema,
+  PlanIndexEntrySchema,
+  PlanMetadataSchema,
+  PlanSnapshotSchema,
+  PlanStatusResponseSchema,
+  PlanStatusValues,
+  PlanViewTabValues,
+  ROUTES,
+  RegisterServerRequestSchema,
+  RegisterServerResponseSchema,
+  ReviewCommentSchema,
+  ReviewFeedbackSchema,
+  SetSessionTokenRequestSchema,
+  SetSessionTokenResponseSchema,
+  SubscriptionClientIdSchema,
+  ThreadCommentSchema,
+  ThreadSchema,
+  UnregisterServerRequestSchema,
+  UnregisterServerResponseSchema,
+  UpdatePlanContentRequestSchema,
+  UpdatePlanContentResponseSchema,
+  UpdatePresenceRequestSchema,
+  UpdatePresenceResponseSchema,
+  VALID_STATUS_TRANSITIONS,
+  YDOC_KEYS,
+  a2aToClaudeCode,
+  addArtifact,
+  addConversationVersion,
+  addDeliverable,
+  addPRReviewComment,
+  addPlanTag,
+  addSnapshot,
+  answerInputRequest,
+  appRouter,
+  approveUser,
+  archivePlan,
+  asAwarenessClientId,
+  asGitHubUsername,
+  asPlanId,
+  asWebRTCPeerId,
+  assertNever,
+  assertNeverP2PMessage,
+  buildInviteUrl,
+  cancelInputRequest,
+  claudeCodeToA2A,
+  clearAgentPresence,
+  clearEventViewedBy,
+  clearPlanIndexViewedBy,
+  conversationRouter,
+  createGitHubArtifact,
+  createHandedOffConversationVersion,
+  createInitialConversationVersion,
+  createInputRequest,
+  createLinkedPR,
+  createLocalArtifact,
+  createPlanSnapshot,
+  createPlanUrl,
+  createPlanUrlWithHistory,
+  createUserResolver,
+  decodeChunkMessage,
+  decodeExportEndMessage,
+  decodeExportStartMessage,
+  decodeP2PMessage,
+  decodePlan,
+  encodeChunkMessage,
+  encodeExportEndMessage,
+  encodeExportStartMessage,
+  encodePlan,
+  extractDeliverables,
+  extractMentions,
+  extractTextFromCommentBody,
+  formatAsClaudeCodeJSONL,
+  formatDeliverablesForLLM,
+  formatThreadsForLLM,
+  getAgentPresence,
+  getAgentPresences,
+  getAllEventViewedByForPlan,
+  getAllTagsFromIndex,
+  getAllViewedByFromIndex,
+  getApprovedUsers,
+  getArtifactUrl,
+  getArtifacts,
+  getConversationVersions,
+  getDeliverables,
+  getLatestSnapshot,
+  getLinkedPR,
+  getLinkedPRs,
+  getPRReviewComments,
+  getPRReviewCommentsForPR,
+  getPlanEvents,
+  getPlanFromUrl,
+  getPlanIndex,
+  getPlanIndexEntry,
+  getPlanMetadata,
+  getPlanMetadataWithValidation,
+  getPlanOwnerId,
+  getRejectedUsers,
+  getSnapshots,
+  getStepCompletions,
+  getTokenTimeRemaining,
+  getViewedBy,
+  getViewedByFromIndex,
+  hookRouter,
+  initPlanMetadata,
+  isApprovalRequired,
+  isConversationChunk,
+  isConversationExportEnd,
+  isConversationExportStart,
+  isEventUnread,
+  isInboxWorthy,
+  isP2PConversationMessage,
+  isPlanUnread,
+  isStepCompleted,
+  isThread,
+  isUrlEncodedPlanV1,
+  isUrlEncodedPlanV2,
+  isUserApproved,
+  isUserRejected,
+  isValidYDocKey,
+  linkArtifactToDeliverable,
+  linkPR,
+  logPlanEvent,
+  markEventAsViewed,
+  markPlanAsViewed,
+  markVersionHandedOff,
+  parseClaudeCodeOrigin,
+  parseClaudeCodeTranscriptString,
+  parseInviteFromUrl,
+  parseThreads,
+  planRouter,
+  rejectUser,
+  removeArtifact,
+  removePRReviewComment,
+  removePlanIndexEntry,
+  removePlanTag,
+  removeViewedByFromIndex,
+  resolvePRReviewComment,
+  revokeUser,
+  setAgentPresence,
+  setPlanIndexEntry,
+  setPlanMetadata,
+  subscriptionRouter,
+  summarizeA2AConversation,
+  toggleStepCompletion,
+  touchPlanIndexEntry,
+  transitionPlanStatus,
+  unarchivePlan,
+  unlinkPR,
+  unrejectUser,
+  updateLinkedPRStatus,
+  updatePlanIndexViewedBy,
+  validateA2AMessages
+};