@rallycry/conveyor-mcp 4.3.6 → 4.3.8

package/dist/{chunk-OAHDLTC6.js → chunk-NQWURJDR.js}

@@ -140,6 +140,15 @@ var ConveyorConnection = class {
       3e4
     );
   }
+  // ── Grafana Logs ────────────────────────────────────────────────────
+  queryGrafanaLogs(params) {
+    const { projectId, ...rest } = params;
+    return this.call(
+      "queryProjectGrafanaLogs",
+      { projectId: this.resolveProjectId(projectId), ...rest },
+      3e4
+    );
+  }
   // ── Task Queries ────────────────────────────────────────────────────
   listTasks(params) {
     const { projectId, ...rest } = params;
@@ -317,6 +326,13 @@ var ConveyorConnection = class {
       3e4
     );
   }
+  getOnboardingStep(projectId) {
+    return this.call(
+      "getProjectOnboardingStep",
+      { projectId: this.resolveProjectId(projectId) },
+      3e4
+    );
+  }
   // ── Review Flow ─────────────────────────────────────────────────────
   async approveTask(taskId, projectId, risk) {
     const targetProjectId = this.resolveProjectId(projectId);
@@ -621,4 +637,4 @@ var ConveyorConnection = class {
 export {
   ConveyorConnection
 };
-//# sourceMappingURL=chunk-OAHDLTC6.js.map
+//# sourceMappingURL=chunk-NQWURJDR.js.map

package/dist/chunk-NQWURJDR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/connection.ts"],"sourcesContent":["/* oxlint-disable max-lines -- central MCP socket client; split after service-call helpers are extracted */\nimport { io, type Socket } from \"socket.io-client\";\n\nexport interface ConveyorMcpConfig {\n  apiUrl: string;\n  projectToken: string;\n  projectId?: string;\n}\n\n/**\n * Canonical risk levels — kept in lockstep with `RISK_LEVELS` in\n * `@project/shared` (conveyor-mcp is published standalone and does not depend on\n * the shared package, so the vocabulary is duplicated here).\n */\nexport type RiskLevel = \"critical\" | \"high\" | \"medium\" | \"low\";\n\n/** A single PTY output frame broadcast on the `pty:data` room event. */\nexport interface PtyDataChunk {\n  sessionId: string;\n  seq: number;\n  data: string;\n  cols?: number;\n  rows?: number;\n}\n\n/** Ring-buffer snapshot returned by `ptyAttach` for catch-up replay. */\nexport interface PtyAttachSnapshot {\n  sessionId: string;\n  chunks: { seq: number; data: string }[];\n  cols: number;\n  rows: number;\n  totalBytes: number;\n}\n\n/**\n * Result of `getActivePtySession`. `sessionId` is null until the cloud agent\n * has booted a PTY and produced at least one ring frame (readiness signal).\n */\nexport interface ActivePtySession {\n  sessionId: string | null;\n  cols?: number;\n  rows?: number;\n}\n\nexport interface WorkspaceAttachInfo {\n  taskId: string;\n  sessionId: string;\n  workspaceRoot: string;\n  tunnelUrl: string;\n  attachToken: string;\n  expiresAt: string;\n  previewPorts: Array<{ port: number; label: string }>;\n  previewUrls: Record<string, string>;\n  ssh?: {\n    remotePort: number;\n    preferredLocalPort: number;\n    username: string;\n  };\n}\n\n/** One Cloud Logging entry as returned by the API's queryProjectGcpLogs. */\nexport interface GcpLogEntry {\n  timestamp: string;\n  severity: string;\n  message: string;\n  resource: Record<string, string>;\n  labels: Record<string, string>;\n  resourceType?: string;\n  insertId?: string;\n  trace?: string;\n  httpRequest?: { status?: number; method?: string; url?: string; latencyMs?: number };\n  payload?: string;\n  payloadTruncated?: boolean;\n}\n\nexport interface GcpLogQueryResult {\n  entries: GcpLogEntry[];\n  hasMore: boolean;\n  nextPageToken?: string;\n  scopedServices?: string[];\n  error?: string;\n}\n\n/** Loki entries normalize onto the same row shape as Cloud Logging entries. */\nexport interface GrafanaLogQueryResult {\n  entries: GcpLogEntry[];\n  hasMore: boolean;\n  /** The LogQL the server composed or executed — agents can iterate on it. */\n  logql?: string;\n  error?: string;\n}\n\n/**\n * One row of the project onboarding checklist. Mirrors the API's\n * `ReadinessCheck` (conveyor-mcp is published standalone and does not depend on\n * `@project/shared`, so the shape is duplicated here).\n */\nexport interface OnboardingCheck {\n  key: string;\n  status: \"ok\" | \"warn\" | \"fail\";\n  reason: string;\n  fix?: {\n    label: string;\n    href?: string | null;\n    action?: string;\n  };\n}\n\n/** Result of `get_onboarding_status` — the project's setup readiness report. */\nexport interface OnboardingStatus {\n  ok: boolean;\n  checks: OnboardingCheck[];\n  bypassedAt: string | null;\n}\n\n/** The single next onboarding step. Mirrors the API's `OnboardingStep`. */\nexport interface OnboardingStep {\n  key: string;\n  status: \"warn\" | \"fail\";\n  title: string;\n  reason: string;\n  guidance: string;\n  autoFixable: boolean;\n  fix?: {\n    label: string;\n    href?: string | null;\n    action?: string;\n  };\n  connectUrls?: Record<string, string>;\n}\n\n/** Result of `get_onboarding_step` — the choose-your-own-adventure step driver.\n *  Mirrors the API's `OnboardingStepReport`. */\nexport interface OnboardingStepReport {\n  done: boolean;\n  ok: boolean;\n  bypassedAt: string | null;\n  step: OnboardingStep | null;\n  remaining: Array<{ key: string; status: \"warn\" | \"fail\"; reason: string }>;\n  checks: OnboardingCheck[];\n}\n\nexport interface MoveCardResult {\n  cardId: string;\n  sourceProjectId: string;\n  destinationProjectId: string;\n  slug: string;\n  clearedFields: string[];\n}\n\nexport interface ProjectConnectUrls {\n  gcpConnect: string;\n  gcpSettings: string;\n  memberSettings: string;\n  projectSettings: string;\n  setupWizard: string;\n}\n\nexport interface TagSummary {\n  id: string;\n  name: string;\n  color: string;\n  description?: string | null;\n}\n\nexport interface PrioritySummary {\n  id: string;\n  value: number;\n  name: string;\n  color: string;\n  description?: string | null;\n}\n\ntype SocketCallback = (response: { success: boolean; data?: unknown; error?: string }) => void;\n\nconst NO_PROJECT_SELECTED_MESSAGE =\n  \"No Conveyor project selected. Pass projectId to this tool or configure CONVEYOR_PROJECT_ID.\";\n\n/** Auth failures never recover on retry — match them to fail fast with guidance. */\nconst AUTH_ERROR_RE = /token|unauthor|forbidden|not authenticated|invalid auth/i;\n\n/**\n * Turn a raw server error into an actionable message. Most errors pass through\n * unchanged; the common-but-opaque \"Insufficient permissions\" gets the missing\n * context about why (project role too low) and how to fix it.\n */\nfunction enrichToolError(error?: string, fallback?: string): string {\n  const base = error ?? fallback ?? \"Request failed\";\n  if (/insufficient permissions/i.test(base)) {\n    return (\n      `${base}: your Conveyor project role can't perform this action. ` +\n      `Creating/updating tasks, builds, and PRs requires Moderate access or higher — ` +\n      `ask a project admin to raise your role.`\n    );\n  }\n  return base;\n}\n\nexport class ConveyorConnection {\n  private socket: Socket | null = null;\n  private config: ConveyorMcpConfig;\n\n  constructor(config: ConveyorMcpConfig) {\n    this.config = config;\n  }\n\n  get projectId(): string {\n    return this.resolveProjectId();\n  }\n\n  private resolveProjectId(projectId?: string): string {\n    const resolved = projectId ?? this.config.projectId;\n    if (!resolved) throw new Error(NO_PROJECT_SELECTED_MESSAGE);\n    return resolved;\n  }\n\n  private normalizeProjectList(response: unknown): unknown[] {\n    if (Array.isArray(response)) return response;\n    if (typeof response !== \"object\" || response === null) return [];\n    const record = response as Record<string, unknown>;\n    if (Array.isArray(record.items)) return record.items;\n    if (Array.isArray(record.projects)) return record.projects;\n    if (Array.isArray(record.data)) return record.data;\n    return [];\n  }\n\n  connect(): Promise<void> {\n    return new Promise((resolve, reject) => {\n      let settled = false;\n      let attempts = 0;\n      const maxAttempts = 15;\n\n      this.socket = io(this.config.apiUrl, {\n        auth: {\n          projectToken: this.config.projectToken,\n          runnerMode: \"project\",\n        },\n        transports: [\"websocket\"],\n        reconnection: true,\n        reconnectionAttempts: Infinity,\n        reconnectionDelay: 2000,\n        reconnectionDelayMax: 30000,\n        randomizationFactor: 0.3,\n        extraHeaders: { \"ngrok-skip-browser-warning\": \"true\" },\n      });\n\n      this.socket.on(\"connect\", () => {\n        if (!settled) {\n          settled = true;\n          // Subscribe to project room for events\n          this.socket?.emit(\"projectService:subscribe\", { id: this.config.projectId });\n          resolve();\n        }\n      });\n\n      this.socket.on(\"connect_error\", (err) => {\n        const message = err?.message ?? \"unknown error\";\n        // An auth rejection (e.g. \"Invalid project token\") will never succeed on\n        // retry, so fail fast with an actionable message instead of silently\n        // retrying for ~30s and then dying with a generic error.\n        if (!settled && AUTH_ERROR_RE.test(message)) {\n          settled = true;\n          this.socket?.close();\n          reject(\n            new Error(\n              `Conveyor rejected the connection: ${message}. The project token is ` +\n                `likely invalid or expired — regenerate it in the web app ` +\n                `(User Settings → Connect Claude Code) and update CONVEYOR_USER_TOKEN ` +\n                `(or legacy CONVEYOR_PROJECT_TOKEN).`,\n            ),\n          );\n          return;\n        }\n        attempts++;\n        if (!settled && attempts >= maxAttempts) {\n          settled = true;\n          reject(new Error(`Failed to connect to ${this.config.apiUrl}: ${message}`));\n        }\n      });\n    });\n  }\n\n  // ── Service method call (agentSessionService:*) ─────────────────────\n\n  private call<T>(method: string, data: unknown, timeoutMs = 15_000): Promise<T> {\n    const socket = this.socket;\n    if (!socket) throw new Error(\"Not connected\");\n\n    const TIMEOUT_MS = timeoutMs;\n\n    return Promise.race([\n      new Promise<T>((resolve, reject) => {\n        socket.emit(`agentSessionService:${method}`, data, ((response: {\n          success: boolean;\n          data?: T;\n          error?: string;\n        }) => {\n          if (response.success) {\n            resolve(response.data as T);\n          } else {\n            reject(new Error(enrichToolError(response.error, `${method} failed`)));\n          }\n        }) as SocketCallback);\n      }),\n      new Promise<never>((_, reject) => {\n        setTimeout(() => {\n          reject(new Error(`Request timed out: ${method}`));\n        }, TIMEOUT_MS);\n      }),\n    ]);\n  }\n\n  /**\n   * Fire-and-forget emit (no ack). The quickdraw-core server method handler\n   * invokes the ack callback via optional chaining, so omitting it still runs\n   * the full auth/schema/ACL pipeline — it just skips the response round-trip.\n   * Used for high-frequency PTY input/resize so each keystroke does not arm a\n   * 15s timeout timer.\n   */\n  private emit(method: string, data: unknown): void {\n    const socket = this.socket;\n    if (!socket) throw new Error(\"Not connected\");\n    socket.emit(`agentSessionService:${method}`, data);\n  }\n\n  private callService<T>(\n    serviceName: string,\n    method: string,\n    data: unknown,\n    timeoutMs = 15_000,\n  ): Promise<T> {\n    const socket = this.socket;\n    if (!socket) throw new Error(\"Not connected\");\n    return Promise.race([\n      new Promise<T>((resolve, reject) => {\n        socket.emit(`${serviceName}:${method}`, data, ((response: {\n          success: boolean;\n          data?: T;\n          error?: string;\n        }) => {\n          if (response.success) {\n            resolve(response.data as T);\n          } else {\n            reject(new Error(enrichToolError(response.error, `${method} failed`)));\n          }\n        }) as SocketCallback);\n      }),\n      new Promise<never>((_, reject) => {\n        setTimeout(() => {\n          reject(new Error(`Request timed out: ${serviceName}:${method}`));\n        }, timeoutMs);\n      }),\n    ]);\n  }\n\n  // ── GCP Logs ────────────────────────────────────────────────────────\n\n  queryGcpLogs(params: {\n    projectId?: string;\n    env?: \"prod\" | \"dev\" | \"claudespace\";\n    severity?: string;\n    services?: string[];\n    sqlInstances?: string[];\n    allServices?: boolean;\n    search?: string;\n    filter?: string;\n    startTime?: string;\n    endTime?: string;\n    limit?: number;\n    pageToken?: string;\n  }): Promise<GcpLogQueryResult> {\n    const { projectId, ...rest } = params;\n    return this.call(\n      \"queryProjectGcpLogs\",\n      { projectId: this.resolveProjectId(projectId), ...rest },\n      30_000,\n    );\n  }\n\n  // ── Grafana Logs ────────────────────────────────────────────────────\n\n  queryGrafanaLogs(params: {\n    projectId?: string;\n    env?: \"prod\" | \"dev\";\n    services?: string[];\n    level?: \"debug\" | \"info\" | \"warn\" | \"error\" | \"fatal\";\n    search?: string;\n    logql?: string;\n    startTime?: string;\n    endTime?: string;\n    limit?: number;\n  }): Promise<GrafanaLogQueryResult> {\n    const { projectId, ...rest } = params;\n    return this.call(\n      \"queryProjectGrafanaLogs\",\n      { projectId: this.resolveProjectId(projectId), ...rest },\n      30_000,\n    );\n  }\n\n  // ── Task Queries ────────────────────────────────────────────────────\n\n  listTasks(params: {\n    projectId?: string;\n    status?: string;\n    typeFilters?: string[];\n    assigneeId?: string;\n    unassigned?: boolean;\n    subProjectId?: string;\n    limit?: number;\n  }): Promise<unknown[]> {\n    const { projectId, ...rest } = params;\n    return this.call(\"listProjectTasks\", {\n      projectId: this.resolveProjectId(projectId),\n      ...rest,\n    });\n  }\n\n  getTask(taskId: string, projectId?: string): Promise<unknown> {\n    return this.call(\"getProjectTask\", {\n      projectId: this.resolveProjectId(projectId),\n      taskId,\n    });\n  }\n\n  getCardBySlug(slug: string, projectId?: string): Promise<unknown> {\n    return this.call(\"getProjectTask\", {\n      projectId: this.resolveProjectId(projectId),\n      taskId: slug,\n    });\n  }\n\n  searchTasks(params: {\n    projectId?: string;\n    tagNames?: string[];\n    searchQuery?: string;\n    statusFilters?: string[];\n    typeFilters?: string[];\n    assigneeId?: string;\n    unassigned?: boolean;\n    subProjectId?: string;\n    limit?: number;\n  }): Promise<unknown[]> {\n    const { projectId, ...rest } = params;\n    return this.call(\"searchProjectTasks\", {\n      projectId: this.resolveProjectId(projectId),\n      ...rest,\n    });\n  }\n\n  // ── Task Mutations ──────────────────────────────────────────────────\n\n  createTask(params: {\n    projectId?: string;\n    title: string;\n    description?: string;\n    plan?: string;\n    status?: string;\n    subProjectId?: string;\n  }): Promise<{ id: string; slug: string }> {\n    const { projectId, ...rest } = params;\n    return this.call(\"createProjectTask\", {\n      projectId: this.resolveProjectId(projectId),\n      ...rest,\n    });\n  }\n\n  updateTask(params: {\n    projectId?: string;\n    taskId: string;\n    title?: string;\n    description?: string;\n    plan?: string;\n    status?: string;\n    risk?: RiskLevel | null;\n    assignedUserId?: string | null;\n    subProjectId?: string | null;\n  }): Promise<{\n    id: string;\n    status: string;\n    risk: RiskLevel | null;\n    assignedUserId: string | null;\n  }> {\n    const { projectId, ...rest } = params;\n    return this.call(\"updateProjectTask\", {\n      projectId: this.resolveProjectId(projectId),\n      ...rest,\n    });\n  }\n\n  /** Guarded status transition used by the review tools (approve/request). */\n  transitionTaskStatus(params: {\n    projectId?: string;\n    taskId: string;\n    toStatus: string;\n    expectedFromStatus?: string;\n    risk?: RiskLevel;\n  }): Promise<{ id: string; status: string; risk: RiskLevel | null }> {\n    const { projectId, ...rest } = params;\n    return this.call(\"transitionProjectTaskStatus\", {\n      projectId: this.resolveProjectId(projectId),\n      ...rest,\n    });\n  }\n\n  moveCard(params: {\n    projectId?: string;\n    taskId: string;\n    destinationProjectId: string;\n  }): Promise<MoveCardResult> {\n    const { projectId, ...rest } = params;\n    return this.call(\"moveProjectCard\", {\n      projectId: this.resolveProjectId(projectId),\n      ...rest,\n    });\n  }\n\n  // ── Reviewers & Members ─────────────────────────────────────────────\n\n  addReviewer(params: {\n    projectId?: string;\n    taskId: string;\n    userId: string;\n  }): Promise<{ taskId: string; reviewers: Array<{ userId: string; name: string | null }> }> {\n    const { projectId, ...rest } = params;\n    return this.call(\"addProjectTaskReviewer\", {\n      projectId: this.resolveProjectId(projectId),\n      ...rest,\n    });\n  }\n\n  removeReviewer(params: {\n    projectId?: string;\n    taskId: string;\n    userId: string;\n  }): Promise<{ taskId: string; reviewers: Array<{ userId: string; name: string | null }> }> {\n    const { projectId, ...rest } = params;\n    return this.call(\"removeProjectTaskReviewer\", {\n      projectId: this.resolveProjectId(projectId),\n      ...rest,\n    });\n  }\n\n  listProjectMembers(\n    projectId?: string,\n  ): Promise<Array<{ userId: string; name: string | null; email: string; level: string }>> {\n    return this.call(\"listProjectMembers\", {\n      projectId: this.resolveProjectId(projectId),\n    });\n  }\n\n  async listProjects(): Promise<unknown[]> {\n    const response = await this.call(\"listAccessibleProjects\", { pageSize: 100 });\n    return this.normalizeProjectList(response);\n  }\n\n  // ── Build Management ────────────────────────────────────────────────\n\n  startBuild(taskId: string, projectId?: string): Promise<{ taskId: string; status: string }> {\n    return this.call(\"startProjectBuild\", {\n      projectId: this.resolveProjectId(projectId),\n      taskId,\n    });\n  }\n\n  stopBuild(taskId: string, projectId?: string): Promise<{ taskId: string; stopped: boolean }> {\n    return this.call(\"stopProjectBuild\", {\n      projectId: this.resolveProjectId(projectId),\n      taskId,\n    });\n  }\n\n  sleepTask(\n    taskId: string,\n    projectId?: string,\n  ): Promise<{ taskId: string; codespaceStatus: string }> {\n    return this.callService(\"cloudBuildService\", \"sleepCloudBuild\", {\n      taskId,\n      projectId: this.resolveProjectId(projectId),\n    });\n  }\n\n  resumeTask(taskId: string, projectId?: string): Promise<{ status: string }> {\n    return this.callService(\"cloudBuildService\", \"wakeCodespace\", {\n      taskId,\n      projectId: this.resolveProjectId(projectId),\n    });\n  }\n\n  deleteTaskEnvironment(\n    taskId: string,\n    projectId?: string,\n  ): Promise<{ taskId: string; status: string }> {\n    return this.callService(\"cloudBuildService\", \"deleteTaskEnvironment\", {\n      taskId,\n      projectId: this.resolveProjectId(projectId),\n    });\n  }\n\n  getBuildStatus(\n    taskId: string,\n    projectId?: string,\n  ): Promise<{\n    session: { status: string | null; agentRunnerStatus: string | null } | null;\n  }> {\n    // Uses getProjectTask and extracts the session field\n    return this.call<Record<string, unknown>>(\"getProjectTask\", {\n      projectId: this.resolveProjectId(projectId),\n      taskId,\n    }).then((task) => ({\n      session:\n        (task?.session as {\n          status: string | null;\n          agentRunnerStatus: string | null;\n        }) ?? null,\n    }));\n  }\n\n  getWorkspaceAttachInfo(taskId: string, sshPublicKey?: string): Promise<WorkspaceAttachInfo> {\n    return this.callService(\"cloudBuildService\", \"getWorkspaceAttachInfo\", {\n      taskId,\n      sshPublicKey,\n    });\n  }\n\n  // ── Chat ────────────────────────────────────────────────────────────\n\n  getTaskChat(taskId: string, limit?: number, projectId?: string): Promise<unknown[]> {\n    // Uses getProjectTask and extracts chatMessages\n    return this.call<Record<string, unknown>>(\"getProjectTask\", {\n      projectId: this.resolveProjectId(projectId),\n      taskId,\n    }).then((task) => {\n      const messages = (task?.chatMessages ?? []) as unknown[];\n      return limit ? messages.slice(-limit) : messages;\n    });\n  }\n\n  postToTaskChat(\n    taskId: string,\n    content: string,\n    projectId?: string,\n  ): Promise<{ messageId: string }> {\n    return this.call(\"postToProjectTaskChat\", {\n      projectId: this.resolveProjectId(projectId),\n      taskId,\n      content,\n    });\n  }\n\n  // ── CLI History ─────────────────────────────────────────────────────\n\n  getTaskCli(\n    taskId: string,\n    limit?: number,\n    source?: string,\n    projectId?: string,\n  ): Promise<{ type: string; data: Record<string, unknown>; timestamp: string }[]> {\n    return this.call(\"getProjectTaskCli\", {\n      projectId: this.resolveProjectId(projectId),\n      taskId,\n      limit,\n      source,\n    });\n  }\n\n  // ── Session / Pod State ─────────────────────────────────────────────\n\n  getTaskSessions(\n    taskId: string,\n    projectId?: string,\n  ): Promise<\n    Array<{\n      taskId: string;\n      slug: string;\n      title: string;\n      type: string;\n      status: string;\n      reviewTargetTaskId: string | null;\n      codeReviewStatus: string | null;\n      codeReviewAttempts: number;\n      workspaces: Array<{\n        id: string;\n        purpose: string;\n        desiredState: string;\n        observedState: string;\n        branch: string | null;\n        checkoutRef: string | null;\n        createdAt: string;\n        updatedAt: string;\n        pod: { name: string; namespace: string; phase: string; imageUri: string | null } | null;\n        sessions: Array<{\n          id: string;\n          role: string;\n          mode: string;\n          status: string;\n          userId: string;\n          leaseUntil: string | null;\n          createdAt: string;\n        }>;\n      }>;\n      sessions: Array<{\n        id: string;\n        provider: string;\n        instanceName: string | null;\n        status: string;\n        agentRunnerStatus: string | null;\n        lastHeartbeatAt: string | null;\n        agentRunningAt: string | null;\n        lastAgentEvent: string | null;\n        deletionRequestedAt: string | null;\n        deletionAttempts: number;\n        createdAt: string;\n        stoppedAt: string | null;\n      }>;\n    }>\n  > {\n    return this.call(\"getProjectTaskSessions\", {\n      projectId: this.resolveProjectId(projectId),\n      taskId,\n    });\n  }\n\n  // ── Project Info ────────────────────────────────────────────────────\n\n  listTags(projectId?: string): Promise<{ id: string; name: string; color: string }[]> {\n    return this.call(\"listProjectTags\", {\n      projectId: this.resolveProjectId(projectId),\n    });\n  }\n\n  getProjectSummary(projectId?: string): Promise<unknown> {\n    return this.call(\"getProjectSummary\", {\n      projectId: this.resolveProjectId(projectId),\n    });\n  }\n\n  getOnboardingStatus(projectId?: string): Promise<OnboardingStatus> {\n    // Each readiness probe fans out to GitHub / GCP, so allow more headroom\n    // than the default request timeout.\n    return this.call(\n      \"getProjectOnboardingStatus\",\n      { projectId: this.resolveProjectId(projectId) },\n      30_000,\n    );\n  }\n\n  getOnboardingStep(projectId?: string): Promise<OnboardingStepReport> {\n    // Reuses the same readiness probes (GitHub / GCP fan-out), so allow the same\n    // extended timeout as get_onboarding_status.\n    return this.call(\n      \"getProjectOnboardingStep\",\n      { projectId: this.resolveProjectId(projectId) },\n      30_000,\n    );\n  }\n\n  // ── Review Flow ─────────────────────────────────────────────────────\n\n  async approveTask(\n    taskId: string,\n    projectId?: string,\n    risk?: RiskLevel,\n  ): Promise<{ status: string }> {\n    const targetProjectId = this.resolveProjectId(projectId);\n    // Determine next status based on current status\n    const task = (await this.call(\"getProjectTask\", {\n      projectId: targetProjectId,\n      taskId,\n    })) as { status: string } | null;\n\n    if (!task) throw new Error(\"Task not found\");\n\n    const nextStatus = task.status === \"ReviewPR\" ? \"ReviewDev\" : \"Complete\";\n\n    // Guarded transition; approval attempts a raise-only \"low\" risk by default.\n    const result = await this.transitionTaskStatus({\n      projectId: targetProjectId,\n      taskId,\n      toStatus: nextStatus,\n      expectedFromStatus: task.status,\n      risk: risk ?? \"low\",\n    });\n    return { status: result.status };\n  }\n\n  async requestChanges(\n    taskId: string,\n    feedback: string,\n    projectId?: string,\n    risk?: RiskLevel,\n  ): Promise<void> {\n    const targetProjectId = this.resolveProjectId(projectId);\n    const task = (await this.call(\"getProjectTask\", {\n      projectId: targetProjectId,\n      taskId,\n    })) as { status: string } | null;\n    if (!task) throw new Error(\"Task not found\");\n\n    // Post feedback to task chat then move to InProgress via the guarded\n    // transition; requested changes attempt a raise-only \"medium\" risk.\n    await this.postToTaskChat(taskId, feedback, targetProjectId);\n    await this.transitionTaskStatus({\n      projectId: targetProjectId,\n      taskId,\n      toStatus: \"InProgress\",\n      expectedFromStatus: task.status,\n      risk: risk ?? \"medium\",\n    });\n  }\n\n  approveAndMergePR(\n    childTaskId: string,\n    projectId?: string,\n  ): Promise<{ merged: boolean; childTaskId: string; prNumber: number }> {\n    return this.call(\"approveProjectMergePR\", {\n      projectId: this.resolveProjectId(projectId),\n      childTaskId,\n    });\n  }\n\n  // ── File Attachments ────────────────────────────────────────────────\n\n  listTaskFiles(taskId: string, projectId?: string): Promise<unknown[]> {\n    return this.call(\"listProjectTaskFiles\", {\n      projectId: this.resolveProjectId(projectId),\n      taskId,\n    });\n  }\n\n  getAttachment(\n    taskId: string,\n    fileId: string,\n    opts?: { offset?: number; maxBytes?: number; projectId?: string },\n  ): Promise<unknown> {\n    const payload: Record<string, unknown> = {\n      projectId: this.resolveProjectId(opts?.projectId),\n      taskId,\n      fileId,\n    };\n    if (opts?.offset !== undefined) payload.offset = opts.offset;\n    if (opts?.maxBytes !== undefined) payload.maxBytes = opts.maxBytes;\n    return this.call(\"getProjectAttachment\", payload);\n  }\n\n  requestFileUpload(\n    taskId: string,\n    params: { fileName: string; mimeType: string; fileSize: number; projectId?: string },\n  ): Promise<{ fileId: string; uploadUrl: string }> {\n    const { projectId, ...rest } = params;\n    return this.call(\"requestProjectFileUpload\", {\n      projectId: this.resolveProjectId(projectId),\n      taskId,\n      ...rest,\n    });\n  }\n\n  confirmFileUpload(\n    taskId: string,\n    fileId: string,\n    comment?: string,\n    projectId?: string,\n  ): Promise<{ fileId: string; fileName: string; downloadUrl?: string; messageId?: string }> {\n    const payload: Record<string, unknown> = {\n      projectId: this.resolveProjectId(projectId),\n      taskId,\n      fileId,\n    };\n    if (comment !== undefined) payload.comment = comment;\n    // Confirm verifies the object in GCS before marking it uploaded — allow\n    // extra headroom for the storage round-trips.\n    return this.call(\"confirmProjectFileUpload\", payload, 30_000);\n  }\n\n  // ── Releases ────────────────────────────────────────────────────────\n\n  createRelease(\n    taskIds?: string[],\n    projectId?: string,\n  ): Promise<{ taskId: string; version: string }> {\n    // Full releases create the release branch + PR against GitHub synchronously;\n    // allow the same headroom as createPullRequest.\n    return this.call(\n      \"createProjectRelease\",\n      { projectId: this.resolveProjectId(projectId), taskIds },\n      45_000,\n    );\n  }\n\n  // ── Pull Requests ───────────────────────────────────────────────────\n\n  createPullRequest(params: {\n    projectId?: string;\n    taskId: string;\n    title: string;\n    body: string;\n    head?: string;\n    base?: string;\n  }): Promise<{ prNumber: number; prUrl: string }> {\n    const { projectId, ...rest } = params;\n    // PR creation makes several sequential GitHub API calls (token, create,\n    // existing-PR lookup); allow more headroom than the default request timeout.\n    return this.call(\n      \"createProjectPullRequest\",\n      { projectId: this.resolveProjectId(projectId), ...rest },\n      45_000,\n    );\n  }\n\n  // ── Subtasks ────────────────────────────────────────────────────────\n\n  createSubtask(params: {\n    projectId?: string;\n    parentTaskId: string;\n    title: string;\n    description?: string;\n    plan?: string;\n    ordinal?: number;\n    storyPointValue?: number;\n    followParentStatus?: boolean;\n    dependsOn?: string[];\n  }): Promise<{ id: string; slug: string }> {\n    const { projectId, ...rest } = params;\n    return this.call(\"createProjectSubtask\", {\n      projectId: this.resolveProjectId(projectId),\n      ...rest,\n    });\n  }\n\n  updateSubtask(params: {\n    projectId?: string;\n    subtaskId: string;\n    title?: string;\n    description?: string;\n    plan?: string;\n    status?: string;\n    ordinal?: number;\n    storyPointValue?: number;\n    followParentStatus?: boolean;\n    dependsOn?: string[];\n  }): Promise<{ id: string; status: string }> {\n    const { projectId, ...rest } = params;\n    return this.call(\"updateProjectSubtask\", {\n      projectId: this.resolveProjectId(projectId),\n      ...rest,\n    });\n  }\n\n  listSubtasks(taskId: string, projectId?: string): Promise<unknown[]> {\n    return this.call(\"listProjectSubtasks\", {\n      projectId: this.resolveProjectId(projectId),\n      taskId,\n    });\n  }\n\n  deleteSubtask(subtaskId: string, projectId?: string): Promise<{ deleted: boolean }> {\n    return this.call(\"deleteProjectSubtask\", {\n      projectId: this.resolveProjectId(projectId),\n      subtaskId,\n    });\n  }\n\n  // ── Dependencies ────────────────────────────────────────────────────\n\n  getDependencies(taskId: string, projectId?: string): Promise<unknown[]> {\n    return this.call(\"getProjectTaskDependencies\", {\n      projectId: this.resolveProjectId(projectId),\n      taskId,\n    });\n  }\n\n  addDependency(params: {\n    projectId?: string;\n    taskId: string;\n    dependsOnSlugOrId: string;\n  }): Promise<{ success: boolean }> {\n    const { projectId, ...rest } = params;\n    return this.call(\"addProjectTaskDependency\", {\n      projectId: this.resolveProjectId(projectId),\n      ...rest,\n    });\n  }\n\n  removeDependency(params: {\n    projectId?: string;\n    taskId: string;\n    dependsOnSlugOrId: string;\n  }): Promise<{ success: boolean }> {\n    const { projectId, ...rest } = params;\n    return this.call(\"removeProjectTaskDependency\", {\n      projectId: this.resolveProjectId(projectId),\n      ...rest,\n    });\n  }\n\n  // ── Manual Test Checklist ───────────────────────────────────────────\n\n  listManualTests(\n    taskId: string,\n    projectId?: string,\n  ): Promise<\n    Array<{\n      id: string;\n      type: string;\n      title: string;\n      ordinal: number;\n      createdAt: string;\n      checked: boolean;\n      failures: Array<{ userName: string | null; reason: string | null; createdAt: string }>;\n    }>\n  > {\n    return this.call(\"listProjectManualTests\", {\n      projectId: this.resolveProjectId(projectId),\n      taskId,\n    });\n  }\n\n  setManualTests(\n    taskId: string,\n    items: Array<{ title: string }>,\n    projectId?: string,\n  ): Promise<{ created: number; skipped: number }> {\n    return this.call(\"setProjectManualTests\", {\n      projectId: this.resolveProjectId(projectId),\n      taskId,\n      items,\n    });\n  }\n\n  editManualTest(\n    taskId: string,\n    title: string,\n    newTitle: string,\n    projectId?: string,\n  ): Promise<{ updated: boolean }> {\n    return this.call(\"editProjectManualTest\", {\n      projectId: this.resolveProjectId(projectId),\n      taskId,\n      title,\n      newTitle,\n    });\n  }\n\n  removeManualTest(\n    taskId: string,\n    title: string,\n    projectId?: string,\n  ): Promise<{ removed: boolean }> {\n    return this.call(\"removeProjectManualTest\", {\n      projectId: this.resolveProjectId(projectId),\n      taskId,\n      title,\n    });\n  }\n\n  approveManualTest(\n    taskId: string,\n    title: string,\n    projectId?: string,\n  ): Promise<{ approved: boolean }> {\n    return this.call(\"approveProjectManualTest\", {\n      projectId: this.resolveProjectId(projectId),\n      taskId,\n      title,\n    });\n  }\n\n  rejectManualTest(\n    taskId: string,\n    title: string,\n    reason: string,\n    projectId?: string,\n  ): Promise<{ rejected: boolean }> {\n    return this.call(\"rejectProjectManualTest\", {\n      projectId: this.resolveProjectId(projectId),\n      taskId,\n      title,\n      reason,\n    });\n  }\n\n  queryManualTests(params: {\n    projectId?: string;\n    cardStatuses?: string[];\n    testStatuses?: Array<\"open\" | \"approved\" | \"rejected\">;\n  }): Promise<\n    Array<{\n      taskId: string;\n      slug: string;\n      title: string;\n      status: string;\n      tests: Array<{\n        id: string;\n        title: string;\n        status: \"open\" | \"approved\" | \"rejected\";\n        failures: Array<{ userName: string | null; reason: string | null; createdAt: string }>;\n      }>;\n    }>\n  > {\n    const { projectId, ...rest } = params;\n    return this.call(\"queryProjectManualTests\", {\n      projectId: this.resolveProjectId(projectId),\n      ...rest,\n    });\n  }\n\n  // ── Project Configuration ──────────────────────────────────────────\n\n  getConnectUrls(projectId?: string): Promise<ProjectConnectUrls> {\n    return this.call(\"getProjectConnectUrls\", { projectId: this.resolveProjectId(projectId) });\n  }\n\n  updateProjectConfig(params: {\n    projectId?: string;\n    name?: string;\n    description?: string;\n    settings?: Record<string, unknown>;\n  }): Promise<unknown> {\n    const { projectId, ...rest } = params;\n    return this.callService(\"projectService\", \"updateProject\", {\n      id: this.resolveProjectId(projectId),\n      ...rest,\n    });\n  }\n\n  updateProjectAgentDefaults(params: {\n    projectId?: string;\n    defaultPmAgentId?: string | null;\n    defaultTaskAgentId?: string | null;\n    defaultReviewerAgentId?: string | null;\n    helperAgentId?: string | null;\n  }): Promise<unknown> {\n    const { projectId, ...rest } = params;\n    return this.callService(\"projectService\", \"updateProjectDefaults\", {\n      id: this.resolveProjectId(projectId),\n      ...rest,\n    });\n  }\n\n  listTagsDetailed(projectId?: string): Promise<TagSummary[]> {\n    return this.callService(\"tagService\", \"listTagsWithCounts\", {\n      projectId: this.resolveProjectId(projectId),\n    });\n  }\n\n  createTag(params: {\n    projectId?: string;\n    name: string;\n    color?: string;\n    description?: string;\n  }): Promise<{ id: string }> {\n    const { projectId, ...rest } = params;\n    return this.callService(\"tagService\", \"createTag\", {\n      projectId: this.resolveProjectId(projectId),\n      ...rest,\n    });\n  }\n\n  updateTag(params: {\n    id: string;\n    name?: string;\n    color?: string;\n    description?: string;\n  }): Promise<unknown> {\n    return this.callService(\"tagService\", \"updateTag\", params);\n  }\n\n  deleteTag(id: string): Promise<unknown> {\n    return this.callService(\"tagService\", \"deleteTag\", { id });\n  }\n\n  listPriorities(projectId?: string): Promise<PrioritySummary[]> {\n    return this.callService(\"priorityService\", \"listByProject\", {\n      projectId: this.resolveProjectId(projectId),\n    });\n  }\n\n  createPriority(params: {\n    projectId?: string;\n    value: number;\n    name: string;\n    color: string;\n    description?: string;\n  }): Promise<{ id: string }> {\n    const { projectId, ...rest } = params;\n    return this.callService(\"priorityService\", \"createPriority\", {\n      projectId: this.resolveProjectId(projectId),\n      ...rest,\n    });\n  }\n\n  updatePriority(params: {\n    id: string;\n    value?: number;\n    name?: string;\n    color?: string;\n    description?: string;\n  }): Promise<unknown> {\n    return this.callService(\"priorityService\", \"updatePriority\", params);\n  }\n\n  deletePriority(id: string): Promise<unknown> {\n    return this.callService(\"priorityService\", \"deletePriority\", { id });\n  }\n\n  // ── Suggestions ─────────────────────────────────────────────────────\n\n  createSuggestion(params: {\n    projectId?: string;\n    title: string;\n    description?: string;\n    tagNames?: string[];\n  }): Promise<{ id: string; merged: boolean; mergedIntoId?: string }> {\n    const { projectId, ...rest } = params;\n    return this.call(\"createProjectSuggestion\", {\n      projectId: this.resolveProjectId(projectId),\n      ...rest,\n    });\n  }\n\n  // ── PTY Tunnel Relay (reuses the S2 pty:* envelope) ─────────────────\n\n  /**\n   * Poll target: returns the active cloud PTY session for a task once its ring\n   * buffer has frames. `sessionId` is resolved server-side from `taskId` (never\n   * accepted from the wire), preserving the one-active-session-per-task invariant.\n   */\n  getActivePtySession(taskId: string): Promise<ActivePtySession> {\n    return this.call(\"getActivePtySession\", { taskId });\n  }\n\n  /** Fetch the ring-buffer snapshot for catch-up replay on (re)attach. */\n  ptyAttach(sessionId: string): Promise<PtyAttachSnapshot> {\n    return this.call(\"ptyAttach\", { sessionId });\n  }\n\n  /**\n   * Join the session room so `pty:data` frames are delivered. Uses the standard\n   * quickdraw-core subscribe envelope; \"Read\" is sufficient for output streaming.\n   */\n  subscribeToSession(sessionId: string): void {\n    const socket = this.socket;\n    if (!socket) throw new Error(\"Not connected\");\n    socket.emit(\"agentSessionService:subscribe\", {\n      entryId: sessionId,\n      requiredLevel: \"Read\",\n    });\n  }\n\n  /** Relay a stdin chunk to the cloud PTY (raw utf8, fire-and-forget). */\n  ptyInput(sessionId: string, data: string): void {\n    this.emit(\"ptyInput\", { sessionId, data });\n  }\n\n  /** Relay a terminal resize to the cloud PTY (fire-and-forget). */\n  ptyResize(sessionId: string, cols: number, rows: number): void {\n    this.emit(\"ptyResize\", { sessionId, cols, rows });\n  }\n\n  /** Subscribe to raw PTY output frames. Returns an unsubscribe function. */\n  onPtyData(handler: (chunk: PtyDataChunk) => void): () => void {\n    const socket = this.socket;\n    if (!socket) throw new Error(\"Not connected\");\n    socket.on(\"pty:data\", handler as (...args: unknown[]) => void);\n    return () => {\n      socket.off(\"pty:data\", handler as (...args: unknown[]) => void);\n    };\n  }\n\n  // ── Connection lifecycle ────────────────────────────────────────────\n\n  disconnect(): void {\n    this.socket?.disconnect();\n    this.socket = null;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   ConveyorConnection
-} from "./chunk-OAHDLTC6.js";
+} from "./chunk-NQWURJDR.js";
 
 // src/cli.ts
 import { createRequire } from "module";
@@ -42,6 +42,17 @@ function registerProjectTools(server2, conn2) {
       return { content: [{ type: "text", text: JSON.stringify(status, null, 2) }] };
     }
   );
+  server2.tool(
+    "get_onboarding_step",
+    "Drive project setup one contextual step at a time (the choose-your-own-adventure onboarding flow). Returns { done, ok, step, remaining, checks }: `step` is the SINGLE next thing to configure (fails before warnings) with a human `title`, the `reason`, agent-facing `guidance` on how to resolve it, `autoFixable` (true = you can fix it via gh/git/tools, false = a browser-only step the user must do), an optional `fix` hint, and `connectUrls` (URLs to hand the user for browser-only steps). `remaining` lists the other unresolved checks. Prefer this over get_onboarding_status during setup: call it, resolve the returned step (do it yourself if autoFixable, otherwise give the user the connectUrl and wait), then call again \u2014 repeat until `done` is true. The repository and branches are already configured; never change them. Pass projectId to target a specific project; otherwise the configured default project is used.",
+    {
+      projectId: z.string().optional().describe("Target Conveyor project ID")
+    },
+    async (params) => {
+      const step = await conn2.getOnboardingStep(params.projectId);
+      return { content: [{ type: "text", text: JSON.stringify(step, null, 2) }] };
+    }
+  );
   server2.tool(
     "list_project_members",
     "List project members with user ID, name, email, and access level \u2014 use to resolve a person's name or email to a user ID for task assignment or review. Pass projectId to target a specific project; otherwise the configured default project is used.",
@@ -82,12 +93,14 @@ function registerGetConnectUrls(server2, conn2) {
 function registerUpdateProjectSettings(server2, conn2) {
   server2.tool(
     "update_project_settings",
-    "Update project configuration: name, description, default agent assignments, or a shallow-merged patch of the project settings JSON (e.g. compute tier keys). Requires a Moderate project role. Does NOT touch repositories or branches \u2014 those are configured in the Conveyor UI.",
+    "Update project configuration: name, description, default agent assignments, or a deep-merged patch of the project settings JSON (JSON Merge Patch: nested objects merge recursively, null deletes a key, arrays replace \u2014 a partial patch never wipes sibling keys). Requires a Moderate project role. Does NOT touch repositories or branches \u2014 those are configured in the Conveyor UI.",
     {
       projectId: z2.string().optional().describe("Target Conveyor project ID"),
       name: z2.string().optional().describe("New project name"),
       description: z2.string().optional().describe("New project description"),
-      settings: z2.record(z2.unknown()).optional().describe("Shallow-merged patch of the project settings JSON (advanced)"),
+      settings: z2.record(z2.unknown()).optional().describe(
+        "Deep-merged patch of the project settings JSON (JSON Merge Patch semantics: null deletes a key; advanced)"
+      ),
       defaultPmAgentId: z2.string().nullable().optional().describe("Default PM agent ID"),
       defaultTaskAgentId: z2.string().nullable().optional().describe("Default task agent ID"),
       defaultReviewerAgentId: z2.string().nullable().optional().describe("Default reviewer agent ID"),
@@ -1581,6 +1594,61 @@ async function runQueryGcpLogs(conn2, params, now = Date.now) {
   }
   return [header, ...lines, ...footer].join("\n");
 }
+async function runQueryGrafanaLogs(conn2, params, now = Date.now) {
+  const startTime = params.startTime ?? new Date(now() - (params.sinceMinutes ?? DEFAULT_SINCE_MINUTES) * 6e4).toISOString();
+  const result = await conn2.queryGrafanaLogs({
+    projectId: params.projectId,
+    env: params.env,
+    level: params.level,
+    services: params.services,
+    search: params.search,
+    logql: params.logql,
+    startTime,
+    endTime: params.endTime,
+    limit: params.limit
+  });
+  if (result.error) return result.error;
+  const header = [
+    `env=${params.env ?? "prod"}`,
+    `window=${startTime}\u2192${params.endTime ?? "now"}`,
+    ...params.level ? [`minLevel=${params.level}`] : [],
+    ...result.logql ? [`logql=${truncateLine(result.logql)}`] : [],
+    `entries=${result.entries.length}`
+  ].join(" ");
+  const lines = result.entries.map(formatLogEntryLine);
+  const footer = result.hasMore ? ["-- hit the limit: narrow the window (startTime/endTime) for older lines"] : [];
+  if (lines.length === 0) {
+    return [
+      header,
+      "(no matching log entries \u2014 widen the window, lower minLevel, or drop filters)"
+    ].join("\n");
+  }
+  return [header, ...lines, ...footer].join("\n");
+}
+function registerGrafanaLogTool(server2, conn2) {
+  server2.tool(
+    "query_grafana_logs",
+    "Query the project's connected Grafana (Loki) logs \u2014 the application logs shipped to Grafana Cloud/Loki, complementing query_gcp_logs (GCP infrastructure logs). Start with structured filters (env, level=error, sinceMinutes=60, services), then narrow with search; pass raw LogQL via logql only when structured filters can't express the query (it REPLACES them). The response header echoes the composed LogQL \u2014 iterate on it. Returns compact lines: '<time> <SEVERITY> [<service>] <message>'.",
+    {
+      projectId: z12.string().optional().describe("Target Conveyor project ID"),
+      env: z12.enum(["prod", "dev"]).optional().describe("Configured Grafana env mapping to scope by (default prod)"),
+      sinceMinutes: z12.number().int().min(1).max(10080).optional().describe(
+        "Relative time window ending now, in minutes (default 60). Ignored if startTime is set."
+      ),
+      startTime: z12.string().optional().describe("ISO 8601 lower bound (overrides sinceMinutes)"),
+      endTime: z12.string().optional().describe("ISO 8601 upper bound (default now)"),
+      level: z12.enum(["debug", "info", "warn", "error", "fatal"]).optional().describe("Minimum severity, inclusive \u2014 error returns error and above"),
+      services: z12.array(z12.string()).optional().describe("Restrict to these service_name label values"),
+      search: z12.string().max(256).optional().describe("Substring line filter (exact substring, not regex)"),
+      logql: z12.string().max(2e3).optional().describe("Advanced: raw LogQL query \u2014 REPLACES env/services/level/search composition"),
+      limit: z12.number().int().min(1).max(200).optional().describe("Max entries (default 50)")
+    },
+    async (params) => {
+      const text = await runQueryGrafanaLogs(conn2, params);
+      return { content: [{ type: "text", text }] };
+    }
+  );
+}
 function registerLogTools(server2, conn2) {
   server2.tool(
     "query_gcp_logs",
@@ -1611,6 +1679,7 @@ function registerLogTools(server2, conn2) {
       return { content: [{ type: "text", text }] };
     }
   );
+  registerGrafanaLogTool(server2, conn2);
 }
 
 // src/tools/index.ts