@runlot/api 0.1.0-rc.162 → 0.1.0-rc.164

package/dist/index.js

@@ -16,6 +16,15 @@ function gitQuery(ref, path) {
         q.set("path", path);
     return q.size > 0 ? `?${q.toString()}` : "";
 }
+function obsProfileQS(q = {}) {
+    const p = new URLSearchParams();
+    for (const [k, v] of Object.entries(q)) {
+        if (v !== undefined && v !== "")
+            p.set(k, String(v));
+    }
+    const s = p.toString();
+    return s ? `?${s}` : "";
+}
 export const API_SCOPES = [
     "project:read",
     "deploy",
@@ -405,6 +414,634 @@ export class Client {
     getDeployment(org, name, deploymentId) {
         return this.json("GET", `${this.projectPath(org, name)}/deployments/${encodeURIComponent(deploymentId)}`);
     }
+    /** Completed-front HTTP outcomes only; native crash-free health is unknown. */
+    getReleaseHealth(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/error-releases`);
+    }
+    /** Historical first transition per issue; never substitutes a latest occurrence. */
+    listReleaseIssues(org, name, version, opts) {
+        const q = new URLSearchParams({ kind: opts.kind, windowStart: opts.windowStart, windowEnd: opts.windowEnd });
+        if (opts.cursor !== undefined)
+            q.set("cursor", opts.cursor);
+        return this.json("GET", `${this.projectPath(org, name)}/error-releases/${encodeURIComponent(String(version))}/issues?${q}`);
+    }
+    /** Runlot Errors: the issue stream (docs/customer-error-tracking.md). */
+    listErrorIssues(org, name, opts = {}) {
+        const q = new URLSearchParams();
+        if (opts.status)
+            q.set("status", opts.status);
+        if (opts.query)
+            q.set("query", opts.query);
+        if (opts.cursor)
+            q.set("cursor", opts.cursor);
+        if (opts.limit !== undefined)
+            q.set("limit", String(opts.limit));
+        const qs = q.size > 0 ? `?${q}` : "";
+        return this.json("GET", `${this.projectPath(org, name)}/errors${qs}`);
+    }
+    getErrorIssue(org, name, issueId) {
+        return this.json("GET", `${this.projectPath(org, name)}/errors/${encodeURIComponent(issueId)}`);
+    }
+    updateErrorIssue(org, name, issueId, update) {
+        return this.json("PATCH", `${this.projectPath(org, name)}/errors/${encodeURIComponent(issueId)}`, update);
+    }
+    /** Source context, suspects and owners for the selected stored occurrence, or latest when omitted. */
+    async getErrorInsights(org, name, issueId, opts = {}) {
+        const eventId = opts.eventId;
+        const q = new URLSearchParams();
+        if (eventId !== undefined)
+            q.set("eventId", eventId);
+        const qs = q.size > 0 ? `?${q}` : "";
+        const out = await this.json("GET", `${this.projectPath(org, name)}/errors/${encodeURIComponent(issueId)}/insights${qs}`);
+        if (eventId !== undefined && (eventId === "" || out.eventId !== eventId)) {
+            throw new Error("Code insights did not identify the requested occurrence; this server may not support event selection.");
+        }
+        return out;
+    }
+    listErrorEvents(org, name, issueId, opts = {}) {
+        const q = new URLSearchParams();
+        if (opts.cursor)
+            q.set("cursor", opts.cursor);
+        if (opts.limit !== undefined)
+            q.set("limit", String(opts.limit));
+        const qs = q.size > 0 ? `?${q}` : "";
+        return this.json("GET", `${this.projectPath(org, name)}/errors/${encodeURIComponent(issueId)}/events${qs}`);
+    }
+    getErrorEvent(org, name, issueId, eventId) {
+        return this.json("GET", `${this.projectPath(org, name)}/errors/${encodeURIComponent(issueId)}/events/${encodeURIComponent(eventId)}`);
+    }
+    /**
+     * Other events of the project joined to this one by front's request ID or a
+     * browser-minted trace ID (§12). Correlation only: issues are never merged.
+     */
+    getRelatedErrorEvents(org, name, issueId, eventId) {
+        return this.json("GET", `${this.projectPath(org, name)}/errors/${encodeURIComponent(issueId)}/events/${encodeURIComponent(eventId)}/related`);
+    }
+    /** An issue's hourly history from the ClickHouse store; `available: false` where there is none. */
+    getErrorHistory(org, name, issueId, days) {
+        const qs = days !== undefined ? `?days=${encodeURIComponent(String(days))}` : "";
+        return this.json("GET", `${this.projectPath(org, name)}/errors/${encodeURIComponent(issueId)}/history${qs}`);
+    }
+    /** Assign an issue to an org member, or clear it with null. */
+    assignErrorIssue(org, name, issueId, userId) {
+        return this.json("PUT", `${this.projectPath(org, name)}/errors/${encodeURIComponent(issueId)}/assignee`, { userId });
+    }
+    listErrorComments(org, name, issueId) {
+        return this.json("GET", `${this.projectPath(org, name)}/errors/${encodeURIComponent(issueId)}/comments`);
+    }
+    /** Plain text, at most 4000 characters; the author is the signed-in user. */
+    addErrorComment(org, name, issueId, body) {
+        return this.json("POST", `${this.projectPath(org, name)}/errors/${encodeURIComponent(issueId)}/comments`, { body });
+    }
+    /** Merge up to ten issues of the same origin into `targetIssueId`. */
+    mergeErrorIssues(org, name, targetIssueId, sourceIssueIds) {
+        return this.json("POST", `${this.projectPath(org, name)}/errors/${encodeURIComponent(targetIssueId)}/merge`, {
+            sourceIssueIds,
+        });
+    }
+    /** Take a merged source back out of the issue it was merged into. */
+    unmergeErrorIssue(org, name, issueId) {
+        return this.json("POST", `${this.projectPath(org, name)}/errors/${encodeURIComponent(issueId)}/unmerge`);
+    }
+    /** Shared stack hints: frame overlap, never a merge or a causal claim. */
+    similarErrorIssues(org, name, issueId) {
+        return this.json("GET", `${this.projectPath(org, name)}/errors/${encodeURIComponent(issueId)}/similar`);
+    }
+    getErrorFingerprintRules(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/errors-fingerprint-rules`);
+    }
+    putErrorFingerprintRules(org, name, rules) {
+        return this.json("PUT", `${this.projectPath(org, name)}/errors-fingerprint-rules`, { rules });
+    }
+    getErrorAlerts(org, name) { return this.json("GET", `${this.projectPath(org, name)}/error-alerts`); }
+    putErrorAlertRule(org, name, id, rule) { return this.json("PUT", `${this.projectPath(org, name)}/error-alerts/rules/${encodeURIComponent(id)}`, rule); }
+    deleteErrorAlertRule(org, name, id) { return this.json("DELETE", `${this.projectPath(org, name)}/error-alerts/rules/${encodeURIComponent(id)}`); }
+    putErrorAlertDestination(org, name, id, input) { return this.json("PUT", `${this.projectPath(org, name)}/error-alerts/destinations/${encodeURIComponent(id)}`, input); }
+    deleteErrorAlertDestination(org, name, id) { return this.json("DELETE", `${this.projectPath(org, name)}/error-alerts/destinations/${encodeURIComponent(id)}`); }
+    getErrorAlertMail(org, name) { return this.json("GET", `${this.projectPath(org, name)}/error-alerts/mail`); }
+    putErrorAlertMail(org, name, preference) { return this.json("PUT", `${this.projectPath(org, name)}/error-alerts/mail`, preference); }
+    listErrorAlertDeliveries(org, name) { return this.json("GET", `${this.projectPath(org, name)}/error-alerts/deliveries`); }
+    // Monitors, downtimes and SLOs (docs/customer-observability.md §17.8, §17.9).
+    // Destinations are the error-alert destinations above, shared by both.
+    listMonitors(org, name) { return this.json("GET", `${this.projectPath(org, name)}/observability/monitors`); }
+    exportMonitors(org, name) { return this.json("GET", `${this.projectPath(org, name)}/observability/monitors/export`); }
+    getMonitor(org, name, id) { return this.json("GET", `${this.projectPath(org, name)}/observability/monitors/${encodeURIComponent(id)}`); }
+    putMonitor(org, name, id, monitor) { return this.json("PUT", `${this.projectPath(org, name)}/observability/monitors/${encodeURIComponent(id)}`, monitor); }
+    deleteMonitor(org, name, id) { return this.json("DELETE", `${this.projectPath(org, name)}/observability/monitors/${encodeURIComponent(id)}`); }
+    getMonitorHistory(org, name, id, limit) {
+        const q = limit ? `?limit=${encodeURIComponent(String(limit))}` : "";
+        return this.json("GET", `${this.projectPath(org, name)}/observability/monitors/${encodeURIComponent(id)}/history${q}`);
+    }
+    testMonitor(org, name, id) { return this.json("POST", `${this.projectPath(org, name)}/observability/monitors/${encodeURIComponent(id)}/test`); }
+    listDowntimes(org, name) { return this.json("GET", `${this.projectPath(org, name)}/observability/downtimes`); }
+    putDowntime(org, name, id, downtime) { return this.json("PUT", `${this.projectPath(org, name)}/observability/downtimes/${encodeURIComponent(id)}`, downtime); }
+    deleteDowntime(org, name, id) { return this.json("DELETE", `${this.projectPath(org, name)}/observability/downtimes/${encodeURIComponent(id)}`); }
+    listSLOs(org, name) { return this.json("GET", `${this.projectPath(org, name)}/observability/slos`); }
+    getSLO(org, name, id) { return this.json("GET", `${this.projectPath(org, name)}/observability/slos/${encodeURIComponent(id)}`); }
+    putSLO(org, name, id, slo) { return this.json("PUT", `${this.projectPath(org, name)}/observability/slos/${encodeURIComponent(id)}`, slo); }
+    deleteSLO(org, name, id) { return this.json("DELETE", `${this.projectPath(org, name)}/observability/slos/${encodeURIComponent(id)}`); }
+    /**
+     * Observability access and governance (customer-observability.md §12, §16, §17.15):
+     * the caller's grants, per-project role overrides, the audit trail, the data page,
+     * caps, export destinations and rehydration.
+     */
+    getObservabilityPermissions(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/permissions`);
+    }
+    listObservabilityRoles(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/roles`);
+    }
+    putObservabilityRole(org, name, userId, grants) {
+        return this.json("PUT", `${this.projectPath(org, name)}/observability/roles/${encodeURIComponent(userId)}`, { grants });
+    }
+    deleteObservabilityRole(org, name, userId) {
+        return this.json("DELETE", `${this.projectPath(org, name)}/observability/roles/${encodeURIComponent(userId)}`);
+    }
+    listObservabilityAudit(org, name, opts = {}) {
+        const q = new URLSearchParams();
+        if (opts.limit !== undefined)
+            q.set("limit", String(opts.limit));
+        if (opts.before !== undefined)
+            q.set("before", opts.before);
+        const qs = q.size > 0 ? `?${q.toString()}` : "";
+        return this.json("GET", `${this.projectPath(org, name)}/observability/audit${qs}`);
+    }
+    getObservabilityData(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/data`);
+    }
+    getObservabilityCaps(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/caps`);
+    }
+    /** Named meters only: a number, -1 (no cap, Pro) or null (the plan's included amount). */
+    putObservabilityCaps(org, name, caps) {
+        return this.json("PUT", `${this.projectPath(org, name)}/observability/caps`, caps);
+    }
+    listObservabilityExports(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/exports`);
+    }
+    getObservabilityExport(org, name, exportId) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/exports/${encodeURIComponent(exportId)}`);
+    }
+    createObservabilityExport(org, name, input) {
+        return this.json("POST", `${this.projectPath(org, name)}/observability/exports`, input);
+    }
+    updateObservabilityExport(org, name, exportId, input) {
+        return this.json("PATCH", `${this.projectPath(org, name)}/observability/exports/${encodeURIComponent(exportId)}`, input);
+    }
+    deleteObservabilityExport(org, name, exportId) {
+        return this.json("DELETE", `${this.projectPath(org, name)}/observability/exports/${encodeURIComponent(exportId)}`);
+    }
+    listObservabilityRehydrations(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/rehydrations`);
+    }
+    getObservabilityRehydration(org, name, jobId) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/rehydrations/${encodeURIComponent(jobId)}`);
+    }
+    /** Loads an archived range back for seven days; the answer is the queued job. */
+    createObservabilityRehydration(org, name, input) {
+        return this.json("POST", `${this.projectPath(org, name)}/observability/rehydrations`, input);
+    }
+    /** `runlot bug-report` (customer-observability.md §14): the CP snapshots what the references name. */
+    createBugReport(org, input) {
+        return this.json("POST", `/v1/orgs/${encodeURIComponent(org)}/bug-reports`, input);
+    }
+    listBugReports(org) {
+        return this.json("GET", `/v1/orgs/${encodeURIComponent(org)}/bug-reports`);
+    }
+    getBugReport(org, reportId, opts = {}) {
+        const qs = opts.snapshot === false ? "?snapshot=0" : "";
+        return this.json("GET", `/v1/orgs/${encodeURIComponent(org)}/bug-reports/${encodeURIComponent(reportId)}${qs}`);
+    }
+    deleteBugReport(org, reportId) {
+        return this.json("DELETE", `/v1/orgs/${encodeURIComponent(org)}/bug-reports/${encodeURIComponent(reportId)}`);
+    }
+    /** Synthetic HTTP checks of the project's own addresses (customer-observability.md §17.11). */
+    listUptimeChecks(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/uptime-checks`);
+    }
+    putUptimeCheck(org, name, id, input) {
+        return this.json("PUT", `${this.projectPath(org, name)}/uptime-checks/${encodeURIComponent(id)}`, input);
+    }
+    deleteUptimeCheck(org, name, id) {
+        return this.json("DELETE", `${this.projectPath(org, name)}/uptime-checks/${encodeURIComponent(id)}`);
+    }
+    listUptimeRuns(org, name, id, limit) {
+        const qs = limit !== undefined ? `?limit=${encodeURIComponent(String(limit))}` : "";
+        return this.json("GET", `${this.projectPath(org, name)}/uptime-checks/${encodeURIComponent(id)}/runs${qs}`);
+    }
+    /** Dashboards (customer-observability.md §17.7). A built-in's id is `builtin:<key>`. */
+    listDashboards(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/dashboards`);
+    }
+    createDashboard(org, name, input) {
+        return this.json("POST", `${this.projectPath(org, name)}/observability/dashboards`, input);
+    }
+    getDashboard(org, name, id) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/dashboards/${encodeURIComponent(id)}`);
+    }
+    putDashboard(org, name, id, input) {
+        return this.json("PUT", `${this.projectPath(org, name)}/observability/dashboards/${encodeURIComponent(id)}`, input);
+    }
+    deleteDashboard(org, name, id) {
+        return this.json("DELETE", `${this.projectPath(org, name)}/observability/dashboards/${encodeURIComponent(id)}`);
+    }
+    /** The `.runlot/dashboards/<key>.json` form of a dashboard. */
+    exportDashboard(org, name, id) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/dashboards/${encodeURIComponent(id)}/export`);
+    }
+    /** Make (or rotate) the public link; the token is shown once. */
+    shareDashboard(org, name, id, isPublic = true) {
+        return this.json("POST", `${this.projectPath(org, name)}/observability/dashboards/${encodeURIComponent(id)}/share`, { public: isPublic });
+    }
+    unshareDashboard(org, name, id) {
+        return this.json("DELETE", `${this.projectPath(org, name)}/observability/dashboards/${encodeURIComponent(id)}/share`);
+    }
+    getDashboardWidgetData(org, name, id, widgetId, req = {}) {
+        return this.json("POST", `${this.projectPath(org, name)}/observability/dashboards/${encodeURIComponent(id)}/widgets/${encodeURIComponent(widgetId)}/data`, req);
+    }
+    getDashboardSettings(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/dashboard-settings`);
+    }
+    putDashboardSettings(org, name, settings) {
+        return this.json("PUT", `${this.projectPath(org, name)}/observability/dashboard-settings`, settings);
+    }
+    /** Deploy and OOM markers for every time series. */
+    getObservabilityMarkers(org, name, range = {}) {
+        const q = new URLSearchParams();
+        if (range.from)
+            q.set("from", range.from);
+        if (range.to)
+            q.set("to", range.to);
+        const qs = q.toString();
+        return this.json("GET", `${this.projectPath(org, name)}/observability/markers${qs ? `?${qs}` : ""}`);
+    }
+    /** Watchdog insights (§17.10). Free: deploy regressions only. */
+    listInsights(org, name, opts = {}) {
+        const q = new URLSearchParams();
+        if (opts.state)
+            q.set("state", opts.state);
+        if (opts.limit !== undefined)
+            q.set("limit", String(opts.limit));
+        const qs = q.toString();
+        return this.json("GET", `${this.projectPath(org, name)}/observability/insights${qs ? `?${qs}` : ""}`);
+    }
+    resolveInsight(org, name, id) {
+        return this.json("POST", `${this.projectPath(org, name)}/observability/insights/${encodeURIComponent(id)}/resolve`);
+    }
+    /** Synthetic checks (§17.11): the uptime checks, including multi-step API checks. */
+    listSynthetics(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/synthetics`);
+    }
+    putSynthetic(org, name, id, input) {
+        return this.json("PUT", `${this.projectPath(org, name)}/synthetics/${encodeURIComponent(id)}`, input);
+    }
+    deleteSynthetic(org, name, id) {
+        return this.json("DELETE", `${this.projectPath(org, name)}/synthetics/${encodeURIComponent(id)}`);
+    }
+    listSyntheticRuns(org, name, id, limit) {
+        const qs = limit !== undefined ? `?limit=${encodeURIComponent(String(limit))}` : "";
+        return this.json("GET", `${this.projectPath(org, name)}/synthetics/${encodeURIComponent(id)}/runs${qs}`);
+    }
+    /** A public dashboard link. Needs no credential. */
+    getSharedDashboard(token) {
+        return this.json("GET", `/v1/shared/dashboards/${encodeURIComponent(token)}`);
+    }
+    getSharedDashboardWidgetData(token, widgetId, req = {}) {
+        return this.json("POST", `/v1/shared/dashboards/${encodeURIComponent(token)}/widgets/${encodeURIComponent(widgetId)}/data`, req);
+    }
+    // Customer observability, APM read side (docs/customer-observability.md §8, §17.2–§17.4,
+    // §17.6). Range options are RFC 3339 times; `step` is seconds or a duration ("5m").
+    obsApmPath(org, name, sub, q) {
+        const qs = new URLSearchParams();
+        for (const [k, v] of Object.entries(q ?? {}))
+            if (v !== undefined && v !== "")
+                qs.set(k, String(v));
+        const tail = qs.size > 0 ? `?${qs}` : "";
+        return `${this.projectPath(org, name)}/observability/${sub}${tail}`;
+    }
+    getObsMetricsOverview(org, name, opts = {}) {
+        return this.json("GET", this.obsApmPath(org, name, "metrics/overview", opts));
+    }
+    getObsMetricsMemory(org, name, opts = {}) {
+        return this.json("GET", this.obsApmPath(org, name, "metrics/memory", opts));
+    }
+    getObsMetricsInfrastructure(org, name, opts = {}) {
+        return this.json("GET", this.obsApmPath(org, name, "metrics/infrastructure", opts));
+    }
+    getObsMetricsCustom(org, name, opts) {
+        return this.json("GET", this.obsApmPath(org, name, "metrics/custom", opts));
+    }
+    getObsMetricsCustomNames(org, name) {
+        return this.json("GET", this.obsApmPath(org, name, "metrics/custom/names"));
+    }
+    listObsRoutes(org, name) {
+        return this.json("GET", this.obsApmPath(org, name, "routes"));
+    }
+    putObsRoute(org, name, input) {
+        return this.json("PUT", this.obsApmPath(org, name, "routes"), input);
+    }
+    getObsAPMRoutes(org, name, opts = {}) {
+        return this.json("GET", this.obsApmPath(org, name, "apm/routes", opts));
+    }
+    getObsAPMBreakdown(org, name, route, opts = {}) {
+        return this.json("GET", this.obsApmPath(org, name, `apm/routes/${encodeURIComponent(route)}/breakdown`, opts));
+    }
+    getObsAPMServiceMap(org, name, opts = {}) {
+        return this.json("GET", this.obsApmPath(org, name, "apm/service-map", opts));
+    }
+    getObsAPMCompare(org, name, a, b, opts = {}) {
+        return this.json("GET", this.obsApmPath(org, name, "apm/compare", { ...opts, a, b }));
+    }
+    listObsAPMTraces(org, name, opts = {}) {
+        return this.json("GET", this.obsApmPath(org, name, "apm/traces", opts));
+    }
+    getObsAPMTrace(org, name, traceId) {
+        return this.json("GET", this.obsApmPath(org, name, `apm/traces/${encodeURIComponent(traceId)}`));
+    }
+    listObsTraceFilters(org, name) {
+        return this.json("GET", this.obsApmPath(org, name, "trace-filters"));
+    }
+    createObsTraceFilter(org, name, input) {
+        return this.json("POST", this.obsApmPath(org, name, "trace-filters"), input);
+    }
+    updateObsTraceFilter(org, name, id, input) {
+        return this.json("PUT", this.obsApmPath(org, name, `trace-filters/${encodeURIComponent(id)}`), input);
+    }
+    deleteObsTraceFilter(org, name, id) {
+        return this.json("DELETE", this.obsApmPath(org, name, `trace-filters/${encodeURIComponent(id)}`));
+    }
+    listObsDBQueries(org, name, opts = {}) {
+        return this.json("GET", this.obsApmPath(org, name, "database/queries", opts));
+    }
+    getObsDBQuery(org, name, fingerprint, opts = {}) {
+        return this.json("GET", this.obsApmPath(org, name, `database/queries/${encodeURIComponent(fingerprint)}`, opts));
+    }
+    getObsDBHealth(org, name) {
+        return this.json("GET", this.obsApmPath(org, name, "database/health"));
+    }
+    /** The continuous profiler's switch (customer-observability.md §17.13). */
+    getObsProfilerSettings(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/profiler`);
+    }
+    /** On, off, or null for the default. Applies from the next deployment or restart. Admin. */
+    putObsProfilerSettings(org, name, enabled) {
+        return this.json("PUT", `${this.projectPath(org, name)}/observability/profiler`, { enabled });
+    }
+    /** The logs/traces sampling override; a null field is the manifest's. */
+    getObsSampling(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/sampling`);
+    }
+    /** Replaces the override (null = the manifest's). Admin. */
+    putObsSampling(org, name, body) {
+        return this.json("PUT", `${this.projectPath(org, name)}/observability/sampling`, body);
+    }
+    listObsProfiles(org, name, q = {}) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/profiles${obsProfileQS({ ...q })}`);
+    }
+    /** The windows within a minute of `ts` — the profile of a slow trace's minute. */
+    nearObsProfiles(org, name, ts) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/profiles/near${obsProfileQS({ ts })}`);
+    }
+    getObsFlamegraph(org, name, q = {}) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/profiles/flamegraph${obsProfileQS({ ...q })}`);
+    }
+    getObsProfileTop(org, name, q = {}) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/profiles/top${obsProfileQS({ ...q })}`);
+    }
+    /** Self-time share per function, version a against version b. */
+    compareObsProfiles(org, name, a, b, q = {}) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/profiles/compare${obsProfileQS({ a, b, ...q })}`);
+    }
+    /** RUM: page views, sessions and p75 vitals over time (Pro). */
+    getObsRUMOverview(org, name, q = {}) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/rum/overview${obsProfileQS({ ...q })}`);
+    }
+    /** RUM by page template, with vitals, long tasks and resource/fetch timings (Pro). */
+    listObsRUMPages(org, name, q = {}) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/rum/pages${obsProfileQS({ ...q })}`);
+    }
+    /** RUM by device class (Pro). */
+    listObsRUMDevices(org, name, q = {}) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/rum/devices${obsProfileQS({ ...q })}`);
+    }
+    /** RUM page views, newest (or slowest LCP) first (Pro). */
+    listObsRUMViews(org, name, q = {}) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/rum/views${obsProfileQS({ ...q })}`);
+    }
+    /** One page view and the server requests it caused (Pro). */
+    getObsRUMView(org, name, viewId) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/rum/views/${encodeURIComponent(viewId)}`);
+    }
+    /** Starts one heap snapshot (Pro, admin; pauses the app while taken). Poll the list. */
+    createObsHeapSnapshot(org, name) {
+        return this.json("POST", `${this.projectPath(org, name)}/observability/heap-snapshots`, {});
+    }
+    listObsHeapSnapshots(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/observability/heap-snapshots`);
+    }
+    /** The download URL of a ready snapshot (a `.heapsnapshot` file). */
+    obsHeapSnapshotURL(org, name, snapshotId) {
+        return new URL(`${this.projectPath(org, name)}/observability/heap-snapshots/${encodeURIComponent(snapshotId)}`, this.opts.baseUrl).toString();
+    }
+    /** A ready snapshot's text (Chrome DevTools heap snapshot JSON). */
+    downloadObsHeapSnapshot(org, name, snapshotId) {
+        return this.text("GET", `${this.projectPath(org, name)}/observability/heap-snapshots/${encodeURIComponent(snapshotId)}`);
+    }
+    getErrorOwnership(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/errors-ownership`);
+    }
+    createErrorOwnershipPin(org, name, input) {
+        return this.json("POST", `${this.projectPath(org, name)}/errors-ownership/pins`, input);
+    }
+    revokeErrorOwnershipPin(org, name, deploymentId, selector) {
+        return this.json("DELETE", `${this.projectPath(org, name)}/errors-ownership/pins/${encodeURIComponent(deploymentId)}/${encodeURIComponent(selector)}`);
+    }
+    getErrorCapturePolicy(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/errors-capture-policy`);
+    }
+    putErrorCapturePolicy(org, name, policy, acknowledgePII = false) {
+        return this.json("PUT", `${this.projectPath(org, name)}/errors-capture-policy`, { policy, acknowledgePII });
+    }
+    // ---- Observability (docs/customer-observability.md §7, §17.5) ----
+    obsPath(org, name) {
+        return `${this.projectPath(org, name)}/observability`;
+    }
+    getObservabilityCapabilities(org, name) {
+        return this.json("GET", `${this.obsPath(org, name)}/capabilities`);
+    }
+    /** Runs a query; `{ available: false }` where there is no event store. */
+    queryObservability(org, name, query) {
+        return this.json("POST", `${this.obsPath(org, name)}/query`, query);
+    }
+    listObservabilityKeys(org, name, opts = {}) {
+        return this.json("GET", `${this.obsPath(org, name)}/keys${obsQS(opts)}`);
+    }
+    listObservabilityValues(org, name, key, opts = {}) {
+        return this.json("GET", `${this.obsPath(org, name)}/values${obsQS({ ...opts, key })}`);
+    }
+    listObservabilityPatterns(org, name, opts = {}) {
+        return this.json("GET", `${this.obsPath(org, name)}/patterns${obsQS(opts)}`);
+    }
+    getObservabilityRequest(org, name, requestId) {
+        return this.json("GET", `${this.obsPath(org, name)}/requests/${encodeURIComponent(requestId)}`);
+    }
+    listSavedQueries(org, name) {
+        return this.json("GET", `${this.obsPath(org, name)}/saved-queries`);
+    }
+    getSavedQuery(org, name, queryId) {
+        return this.json("GET", `${this.obsPath(org, name)}/saved-queries/${encodeURIComponent(queryId)}`);
+    }
+    createSavedQuery(org, name, input) {
+        return this.json("POST", `${this.obsPath(org, name)}/saved-queries`, input);
+    }
+    updateSavedQuery(org, name, queryId, input) {
+        return this.json("PUT", `${this.obsPath(org, name)}/saved-queries/${encodeURIComponent(queryId)}`, input);
+    }
+    deleteSavedQuery(org, name, queryId) {
+        return this.json("DELETE", `${this.obsPath(org, name)}/saved-queries/${encodeURIComponent(queryId)}`);
+    }
+    starSavedQuery(org, name, queryId) {
+        return this.json("PUT", `${this.obsPath(org, name)}/saved-queries/${encodeURIComponent(queryId)}/star`);
+    }
+    unstarSavedQuery(org, name, queryId) {
+        return this.json("DELETE", `${this.obsPath(org, name)}/saved-queries/${encodeURIComponent(queryId)}/star`);
+    }
+    getObservabilityPipeline(org, name) {
+        return this.json("GET", `${this.obsPath(org, name)}/pipeline`);
+    }
+    putObservabilityPipeline(org, name, processors) {
+        return this.json("PUT", `${this.obsPath(org, name)}/pipeline`, { processors });
+    }
+    getObservabilityScanner(org, name) {
+        return this.json("GET", `${this.obsPath(org, name)}/scanner`);
+    }
+    putObservabilityScanner(org, name, scanner) {
+        return this.json("PUT", `${this.obsPath(org, name)}/scanner`, scanner);
+    }
+    /** Runs a scanner (the project's, or `scanner`) over a sample; nothing is stored. */
+    testObservabilityScanner(org, name, text, scanner) {
+        return this.json("POST", `${this.obsPath(org, name)}/scanner/test`, scanner ? { text, scanner } : { text });
+    }
+    /** The whole ingest configuration, shaped as `.runlot/logs.json`. */
+    exportObservabilityLogsConfig(org, name) {
+        return this.json("GET", `${this.obsPath(org, name)}/logs-config`);
+    }
+    listObservabilityLogMetrics(org, name) {
+        return this.json("GET", `${this.obsPath(org, name)}/log-metrics`);
+    }
+    putObservabilityLogMetric(org, name, metric, def) {
+        return this.json("PUT", `${this.obsPath(org, name)}/log-metrics/${encodeURIComponent(metric)}`, def);
+    }
+    deleteObservabilityLogMetric(org, name, metric) {
+        return this.json("DELETE", `${this.obsPath(org, name)}/log-metrics/${encodeURIComponent(metric)}`);
+    }
+    getErrorEventPII(org, name, issueId, eventId) {
+        return this.json("GET", `${this.projectPath(org, name)}/errors/${encodeURIComponent(issueId)}/events/${encodeURIComponent(eventId)}?includePII=true`);
+    }
+    getErrorSettings(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/errors-settings`);
+    }
+    putErrorSettings(org, name, 
+    /** Omitted writable fields preserve their values; ownership assignment defaults off. */
+    settings) {
+        return this.json("PUT", `${this.projectPath(org, name)}/errors-settings`, settings);
+    }
+    /**
+     * One AI diagnosis of an issue, billed to the org's AI credit. There is no
+     * prompt to pass: the control plane builds it from the issue's stored event.
+     * The same `idempotencyKey` again returns the stored answer without a second
+     * charge, so a caller retrying after a timeout must reuse its key.
+     */
+    diagnoseErrorIssue(org, name, issueId, body) {
+        return this.json("POST", `${this.projectPath(org, name)}/errors/${encodeURIComponent(issueId)}/diagnoses`, body);
+    }
+    listErrorDiagnoses(org, name, issueId) {
+        return this.json("GET", `${this.projectPath(org, name)}/errors/${encodeURIComponent(issueId)}/diagnoses`);
+    }
+    fixPath(org, name, issueId) {
+        return `${this.projectPath(org, name)}/errors/${encodeURIComponent(issueId)}/fix-proposals`;
+    }
+    /**
+     * Ask a model to propose a fix for an issue. Billed to the org's AI credit and
+     * writes nothing: the repository, base commit and files are chosen by the control
+     * plane. Reuse `idempotencyKey` on a retry so it is not charged twice.
+     */
+    proposeErrorFix(org, name, issueId, body) {
+        return this.json("POST", this.fixPath(org, name, issueId), body);
+    }
+    listErrorFixProposals(org, name, issueId) {
+        return this.json("GET", this.fixPath(org, name, issueId));
+    }
+    getErrorFixProposal(org, name, issueId, proposalId) {
+        return this.json("GET", `${this.fixPath(org, name, issueId)}/${encodeURIComponent(proposalId)}`);
+    }
+    /**
+     * Write a ready proposal as one commit on its own `runlot/autofix/` branch. It
+     * builds, deploys and merges nothing. `proposalSha` must be the proposal's exactly.
+     */
+    applyErrorFix(org, name, issueId, proposalId, proposalSha) {
+        return this.json("POST", `${this.fixPath(org, name, issueId)}/${encodeURIComponent(proposalId)}/apply`, {
+            proposalSha,
+            acknowledgeUnreviewedCode: true,
+        });
+    }
+    lookupErrorFixProposal(org, name, issueId, key) {
+        return this.request("GET", `${this.fixPath(org, name, issueId)}/lookup`, { headers: { "Idempotency-Key": key } });
+    }
+    lookupErrorFixPreview(org, name, issueId, proposalId, key) {
+        return this.request("GET", `${this.fixPath(org, name, issueId)}/${encodeURIComponent(proposalId)}/previews/lookup`, { headers: { "Idempotency-Key": key } });
+    }
+    lookupErrorFixVerification(org, name, issueId, proposalId, jobId, key) {
+        return this.request("GET", `${this.fixPath(org, name, issueId)}/${encodeURIComponent(proposalId)}/previews/${encodeURIComponent(jobId)}/verify/lookup`, { headers: { "Idempotency-Key": key } });
+    }
+    approveErrorFixPreview(org, name, issueId, proposalId, body) {
+        return this.json("POST", `${this.fixPath(org, name, issueId)}/${encodeURIComponent(proposalId)}/previews`, body);
+    }
+    getErrorFixPreview(org, name, issueId, proposalId, jobId) {
+        return this.json("GET", `${this.fixPath(org, name, issueId)}/${encodeURIComponent(proposalId)}/previews/${encodeURIComponent(jobId)}`);
+    }
+    approveErrorFixPreviewVerification(org, name, issueId, proposalId, jobId, body) {
+        return this.json("POST", `${this.fixPath(org, name, issueId)}/${encodeURIComponent(proposalId)}/previews/${encodeURIComponent(jobId)}/verify`, body);
+    }
+    /** Erase captured issue data, after explicit review. Admin; unmerge first. */
+    deleteErrorIssue(org, name, issueId) {
+        return this.json("DELETE", `${this.projectPath(org, name)}/errors/${encodeURIComponent(issueId)}`);
+    }
+    /** Erase an exact application user ID; anonymous aggregates remain. Admin. */
+    eraseErrorUser(org, name, userId) {
+        return this.json("POST", `${this.projectPath(org, name)}/errors-erasure`, { userId });
+    }
+    /** Untrusted browser histograms and technical-fuse counters, not billed usage. Viewer. */
+    getBrowserTelemetry(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/browser-telemetry`);
+    }
+    /** Unverified feedback whose exact browser error anchor belongs to this issue. Never includes email. */
+    listBrowserFeedback(org, name, issueId) {
+        return this.json("GET", `${this.projectPath(org, name)}/errors/${encodeURIComponent(issueId)}/feedback`);
+    }
+    /** Explicit sensitive read. Admin + errors:pii; optional unverified email only while feedback-email retention is on. */
+    listBrowserFeedbackWithPII(org, name, issueId) {
+        return this.json("GET", `${this.projectPath(org, name)}/errors/${encodeURIComponent(issueId)}/feedback?includePII=true`);
+    }
+    /** The masked structural replay switch, cap and this month's count. Viewer. */
+    getErrorReplaySettings(org, name) {
+        return this.json("GET", `${this.projectPath(org, name)}/errors-replay-settings`);
+    }
+    /**
+     * Both fields are required: `monthlyCap` null is the plan's amount, `0` stops collection,
+     * `-1` removes the cap (Pro). Admin.
+     */
+    putErrorReplaySettings(org, name, settings) {
+        return this.json("PUT", `${this.projectPath(org, name)}/errors-replay-settings`, settings);
+    }
+    /** An issue's complete masked structural replays. Admin, until a granular PII scope exists. */
+    listErrorReplays(org, name, issueId) {
+        return this.json("GET", `${this.projectPath(org, name)}/errors/${encodeURIComponent(issueId)}/replays`);
+    }
+    /** One replay and its re-validated batches, for the sandboxed player. Admin. */
+    getErrorReplay(org, name, issueId, replayId) {
+        return this.json("GET", `${this.projectPath(org, name)}/errors/${encodeURIComponent(issueId)}/replays/${encodeURIComponent(replayId)}`);
+    }
     /**
      * Scheduled runs: what the live deployment declares, when each fires next, and
      * the recent history (docs/cron.md §8). `limit` bounds the history rows only —
@@ -689,11 +1326,31 @@ export class Client {
      * (4xx/5xx) is the same `ApiError` as in every other method.
      */
     async *tailLogs(org, name, opts = {}) {
+        yield* this.tailStream(org, name, opts, undefined);
+    }
+    /**
+     * The live tail as `LogRecord`s — the stored event's shape (`--format json`).
+     * Pings and the end event still arrive as `LogEvent`s.
+     */
+    async *tailLogRecords(org, name, opts = {}) {
+        yield* this.tailStream(org, name, opts, "json");
+    }
+    async *tailStream(org, name, opts, format) {
         const q = new URLSearchParams();
         if (opts.tail !== undefined)
             q.set("tail", String(opts.tail));
         if (opts.follow !== undefined)
             q.set("follow", String(opts.follow));
+        if (opts.level)
+            q.set("level", opts.level);
+        if (opts.source)
+            q.set("source", opts.source);
+        if (opts.q)
+            q.set("q", opts.q);
+        if (opts.requestId)
+            q.set("requestId", opts.requestId);
+        if (format)
+            q.set("format", format);
         const path = `${this.projectPath(org, name)}/logs${q.size ? `?${q}` : ""}`;
         const res = await fetch(new URL(path, this.opts.baseUrl), {
             method: "GET",
@@ -1402,4 +2059,12 @@ export class Client {
         return this.json("POST", `/v1/orgs/${encodeURIComponent(org)}/projects/${encodeURIComponent(name)}/rollback`, { version });
     }
 }
+/** A query string from the defined, non-empty options. */
+function obsQS(opts) {
+    const q = new URLSearchParams();
+    for (const [k, v] of Object.entries(opts))
+        if (v)
+            q.set(k, v);
+    return q.size ? `?${q}` : "";
+}
 //# sourceMappingURL=index.js.map