@medicine-wheel/mcp 4.5.0 → 4.5.2

package/dist/http-store.d.ts

@@ -50,6 +50,14 @@ interface StoredBeat {
     timestamp: string;
     act: number;
     relations_honored: string[];
+    cycle_id?: string;
+    parent_beat_id?: string;
+    sub_beats?: string[];
+    origin?: {
+        producer: string;
+        source_ref?: string;
+        method?: string;
+    };
 }
 interface StoredCycle {
     id: string;
@@ -175,11 +183,40 @@ interface PlanPerspectiveFilters {
     session_id?: string;
     id?: string;
 }
+/** Carries the HTTP status so callers can tell "endpoint absent" from "server broke". */
+export declare class HttpStoreError extends Error {
+    readonly status?: number;
+    readonly url: string;
+    constructor(message: string, url: string, status?: number);
+}
+/** A write that did not land. Kept so a failure survives past the console. */
+export interface WriteFailure {
+    operation: string;
+    url: string;
+    message: string;
+    at: string;
+}
 export declare class HttpStore {
     readonly name = "http";
     private readonly baseUrl;
+    private readonly failures;
+    private readonly inFlight;
     constructor(baseUrl: string);
-    createNode(node: StoredNode): void;
+    /**
+     * Writes keep their statement-call shape — `store.createNode(node)` still
+     * compiles and still returns immediately — but the promise now comes back,
+     * so a caller that awaits learns the truth instead of being told "created"
+     * over a request that 404'd. The internal catch is what keeps a rejection
+     * nobody awaited from taking the server down as an unhandled rejection.
+     */
+    private track;
+    /** Writes that did not land, oldest first. Non-destructive. */
+    getWriteFailures(): WriteFailure[];
+    /** Drain the record — for a caller that has reported the failures onward. */
+    takeWriteFailures(): WriteFailure[];
+    /** Wait for every in-flight write to land or fail. Never rejects. */
+    settleWrites(): Promise<void>;
+    createNode(node: StoredNode): Promise<void>;
     getNode(id: string): Promise<StoredNode | undefined>;
     getAllNodes(limit?: number): Promise<StoredNode[]>;
     getNodesByType(type: string): Promise<StoredNode[]>;
@@ -189,35 +226,36 @@ export declare class HttpStore {
         direction?: string;
         limit?: number;
     }): Promise<StoredNode[]>;
-    createEdge(edge: StoredEdge): void;
+    createEdge(edge: StoredEdge): Promise<void>;
     getAllEdges(): Promise<StoredEdge[]>;
     getEdgesForNode(nodeId: string): Promise<StoredEdge[]>;
     getRelatedNodeIds(nodeId: string): Promise<string[]>;
-    updateEdgeCeremony(fromId: string, toId: string, ceremonyId: string): void;
+    updateEdgeCeremony(fromId: string, toId: string, ceremonyId: string): Promise<void>;
     getRelationalWeb(nodeId: string, depth?: number): Promise<{
         nodes: StoredNode[];
         edges: StoredEdge[];
     }>;
-    logCeremony(ceremony: StoredCeremony): void;
+    logCeremony(ceremony: StoredCeremony): Promise<void>;
     getCeremony(id: string): Promise<StoredCeremony | undefined>;
     getAllCeremonies(limit?: number): Promise<StoredCeremony[]>;
     getCeremoniesByDirection(direction: string): Promise<StoredCeremony[]>;
     getCeremoniesByType(type: string): Promise<StoredCeremony[]>;
-    createBeat(beat: StoredBeat): void;
+    createBeat(beat: StoredBeat): Promise<void>;
     getBeat(id: string): Promise<StoredBeat | undefined>;
     getAllBeats(limit?: number): Promise<StoredBeat[]>;
     getBeatsByDirection(direction: string): Promise<StoredBeat[]>;
-    createCycle(cycle: StoredCycle): void;
+    createCycle(cycle: StoredCycle): Promise<void>;
+    private listCycles;
     getCycle(id: string): Promise<StoredCycle | undefined>;
     getAllCycles(): Promise<{
         active: StoredCycle[];
         archived: StoredCycle[];
     }>;
-    archiveCycle(id: string): void;
-    saveChart(chart: StoredChart): void;
+    archiveCycle(id: string): Promise<void>;
+    saveChart(chart: StoredChart): Promise<void>;
     getChart(id: string): Promise<StoredChart | undefined>;
     getAllCharts(direction?: string): Promise<StoredChart[]>;
-    saveMmot(mmot: StoredMmot): void;
+    saveMmot(mmot: StoredMmot): Promise<void>;
     getMmotsByChart(chartId: string): Promise<StoredMmot[]>;
     registerInquiryWeave(record: StoredInquiryWeave): Promise<void>;
     getInquiryWeave(id: string): Promise<StoredInquiryWeave | undefined>;

package/dist/http-store.d.ts.map

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

package/dist/http-store.js

@@ -9,54 +9,183 @@
  * Default behavior (MW_DATA_DIR / local JSONL) is preserved.
  */
 // ── Helpers ──
+/** Carries the HTTP status so callers can tell "endpoint absent" from "server broke". */
+export class HttpStoreError extends Error {
+    status;
+    url;
+    constructor(message, url, status) {
+        super(message);
+        this.name = 'HttpStoreError';
+        this.url = url;
+        this.status = status;
+    }
+}
+const DEFAULT_TIMEOUT_MS = 15_000;
+const MAX_TRACKED_FAILURES = 50;
+function requestTimeoutMs() {
+    const parsed = Number(process.env.MW_HTTP_TIMEOUT_MS);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : DEFAULT_TIMEOUT_MS;
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function snippet(text) {
+    const flat = text.replace(/\s+/g, ' ').trim();
+    return flat.length > 200 ? `${flat.slice(0, 200)}…` : flat;
+}
+function describeShape(value) {
+    if (value === null)
+        return 'null';
+    if (Array.isArray(value))
+        return 'an array';
+    return `a ${typeof value}`;
+}
+/**
+ * Every request carries a deadline. Without one, a server that accepts the
+ * connection and then never answers parks the MCP server's single thread of
+ * conversation forever — the tool call never returns and never errors.
+ */
+async function httpFetch(url, init) {
+    const method = init?.method ?? 'GET';
+    const timeoutMs = requestTimeoutMs();
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        return await fetch(url, { ...init, signal: controller.signal });
+    }
+    catch (error) {
+        if (controller.signal.aborted) {
+            throw new HttpStoreError(`HTTP ${method} ${url} timed out after ${timeoutMs}ms`, url);
+        }
+        throw new HttpStoreError(`HTTP ${method} ${url} failed: ${errorMessage(error)}`, url);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * A reverse proxy or a misrouted path answers 200 with an HTML page. Left to
+ * res.json(), that surfaces as "Unexpected token <" — which names neither the
+ * endpoint that lied nor what it actually said.
+ */
+async function readJson(res, url, method) {
+    const text = await res.text();
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        const contentType = res.headers.get('content-type') ?? 'no content-type';
+        throw new HttpStoreError(`HTTP ${method} ${url} returned non-JSON (${contentType}): ${snippet(text)}`, url, res.status);
+    }
+}
+/**
+ * The server has drifted between `[...]` and `{ nodes: [...] }` for the same
+ * collection. Accept either. A payload that is neither is a real failure and
+ * must not reach the caller disguised as an empty collection.
+ */
+function readCollection(payload, key, url) {
+    if (Array.isArray(payload))
+        return payload;
+    if (payload !== null && typeof payload === 'object') {
+        const inner = payload[key];
+        if (Array.isArray(inner))
+            return inner;
+    }
+    throw new HttpStoreError(`HTTP GET ${url} returned ${describeShape(payload)} — expected an array or { ${key}: [...] }`, url);
+}
+/** True only when the endpoint itself is absent — never for a server that broke. */
+function isEndpointMissing(error) {
+    return error instanceof HttpStoreError && error.status === 404;
+}
 async function httpGet(url) {
-    const res = await fetch(url);
+    const res = await httpFetch(url);
     if (!res.ok) {
-        throw new Error(`HTTP GET ${url} failed: ${res.status} ${res.statusText}`);
+        const text = await res.text().catch(() => '');
+        throw new HttpStoreError(`HTTP GET ${url} failed: ${res.status} ${res.statusText} — ${snippet(text)}`, url, res.status);
     }
-    return res.json();
+    return (await readJson(res, url, 'GET'));
 }
 async function httpPost(url, body) {
-    const res = await fetch(url, {
+    const res = await httpFetch(url, {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
         body: JSON.stringify(body),
     });
     if (!res.ok) {
         const text = await res.text().catch(() => '');
-        throw new Error(`HTTP POST ${url} failed: ${res.status} ${res.statusText} — ${text}`);
+        throw new HttpStoreError(`HTTP POST ${url} failed: ${res.status} ${res.statusText} — ${snippet(text)}`, url, res.status);
     }
-    return res.json();
+    return (await readJson(res, url, 'POST'));
 }
 // ── HttpStore ──
 export class HttpStore {
     name = 'http';
     baseUrl;
+    failures = [];
+    inFlight = new Set();
     constructor(baseUrl) {
         // Strip trailing slash for consistent URL construction
         this.baseUrl = baseUrl.replace(/\/+$/, '');
     }
+    // === Write accountability ===
+    /**
+     * Writes keep their statement-call shape — `store.createNode(node)` still
+     * compiles and still returns immediately — but the promise now comes back,
+     * so a caller that awaits learns the truth instead of being told "created"
+     * over a request that 404'd. The internal catch is what keeps a rejection
+     * nobody awaited from taking the server down as an unhandled rejection.
+     */
+    track(operation, url, request) {
+        const settled = request.then(() => undefined, (error) => {
+            const message = errorMessage(error);
+            console.error(`[http-store] ${operation} failed: ${message}`);
+            this.failures.push({ operation, url, message, at: new Date().toISOString() });
+            if (this.failures.length > MAX_TRACKED_FAILURES)
+                this.failures.shift();
+            throw error;
+        });
+        // Attaching a handler to `settled` is what marks it handled for the
+        // call sites that ignore the returned promise.
+        const quiet = settled.catch(() => undefined);
+        this.inFlight.add(quiet);
+        void quiet.then(() => { this.inFlight.delete(quiet); });
+        return settled;
+    }
+    /** Writes that did not land, oldest first. Non-destructive. */
+    getWriteFailures() {
+        return [...this.failures];
+    }
+    /** Drain the record — for a caller that has reported the failures onward. */
+    takeWriteFailures() {
+        return this.failures.splice(0, this.failures.length);
+    }
+    /** Wait for every in-flight write to land or fail. Never rejects. */
+    async settleWrites() {
+        while (this.inFlight.size > 0) {
+            await Promise.all([...this.inFlight]);
+        }
+    }
     // === Nodes ===
     createNode(node) {
-        // Fire-and-forget; callers don't await in JsonlStore either
-        httpPost(`${this.baseUrl}/api/nodes`, node).catch(err => console.error(`[http-store] createNode failed: ${err}`));
+        const url = `${this.baseUrl}/api/nodes`;
+        return this.track('createNode', url, httpPost(url, node));
     }
     async getNode(id) {
         const all = await this.getAllNodes();
         return all.find(n => n.id === id);
     }
     async getAllNodes(limit) {
-        const data = await httpGet(`${this.baseUrl}/api/nodes`);
-        const nodes = data.nodes ?? [];
+        const url = `${this.baseUrl}/api/nodes`;
+        const nodes = readCollection(await httpGet(url), 'nodes', url);
         return limit !== undefined ? nodes.slice(0, limit) : nodes;
     }
     async getNodesByType(type) {
-        const data = await httpGet(`${this.baseUrl}/api/nodes?type=${encodeURIComponent(type)}`);
-        return data.nodes ?? [];
+        const url = `${this.baseUrl}/api/nodes?type=${encodeURIComponent(type)}`;
+        return readCollection(await httpGet(url), 'nodes', url);
     }
     async getNodesByDirection(direction) {
-        const data = await httpGet(`${this.baseUrl}/api/nodes?direction=${encodeURIComponent(direction)}`);
-        return data.nodes ?? [];
+        const url = `${this.baseUrl}/api/nodes?direction=${encodeURIComponent(direction)}`;
+        return readCollection(await httpGet(url), 'nodes', url);
     }
     async searchNodes(query, opts = {}) {
         // Server has no search endpoint yet — fetch all and filter client-side
@@ -72,10 +201,12 @@ export class HttpStore {
     }
     // === Edges ===
     createEdge(edge) {
-        httpPost(`${this.baseUrl}/api/edges`, edge).catch(err => console.error(`[http-store] createEdge failed: ${err}`));
+        const url = `${this.baseUrl}/api/edges`;
+        return this.track('createEdge', url, httpPost(url, edge));
     }
     async getAllEdges() {
-        return httpGet(`${this.baseUrl}/api/edges`);
+        const url = `${this.baseUrl}/api/edges`;
+        return readCollection(await httpGet(url), 'edges', url);
     }
     async getEdgesForNode(nodeId) {
         const edges = await this.getAllEdges();
@@ -94,28 +225,20 @@ export class HttpStore {
     }
     updateEdgeCeremony(fromId, toId, ceremonyId) {
         // No dedicated server endpoint — fetch, update, and re-post
-        (async () => {
-            try {
-                const edges = await httpGet(`${this.baseUrl}/api/edges`);
-                for (const edge of edges) {
-                    if ((edge.from_id === fromId && edge.to_id === toId) ||
-                        (edge.from_id === toId && edge.to_id === fromId)) {
-                        await httpPost(`${this.baseUrl}/api/edges`, {
-                            ...edge,
-                            ceremony_honored: true,
-                            ceremony_id: ceremonyId,
-                        });
-                    }
+        const url = `${this.baseUrl}/api/edges`;
+        return this.track('updateEdgeCeremony', url, (async () => {
+            const edges = await this.getAllEdges();
+            for (const edge of edges) {
+                if ((edge.from_id === fromId && edge.to_id === toId) ||
+                    (edge.from_id === toId && edge.to_id === fromId)) {
+                    await httpPost(url, { ...edge, ceremony_honored: true, ceremony_id: ceremonyId });
                 }
             }
-            catch (err) {
-                console.error(`[http-store] updateEdgeCeremony failed: ${err}`);
-            }
-        })();
+        })());
     }
     async getRelationalWeb(nodeId, depth = 2) {
         const allNodes = await this.getAllNodes();
-        const allEdges = await httpGet(`${this.baseUrl}/api/edges`);
+        const allEdges = await this.getAllEdges();
         const nodeMap = new Map(allNodes.map(n => [n.id, n]));
         const visited = new Set();
         const resultNodes = [];
@@ -143,35 +266,38 @@ export class HttpStore {
     }
     // === Ceremonies ===
     logCeremony(ceremony) {
-        httpPost(`${this.baseUrl}/api/ceremonies`, ceremony).catch(err => console.error(`[http-store] logCeremony failed: ${err}`));
+        const url = `${this.baseUrl}/api/ceremonies`;
+        return this.track('logCeremony', url, httpPost(url, ceremony));
     }
     async getCeremony(id) {
         const all = await this.getAllCeremonies();
         return all.find(c => c.id === id);
     }
     async getAllCeremonies(limit) {
-        const data = await httpGet(`${this.baseUrl}/api/ceremonies`);
-        const sorted = (data.ceremonies ?? []).sort((a, b) => Date.parse(b.timestamp) - Date.parse(a.timestamp));
+        const url = `${this.baseUrl}/api/ceremonies`;
+        const sorted = readCollection(await httpGet(url), 'ceremonies', url).sort((a, b) => Date.parse(b.timestamp) - Date.parse(a.timestamp));
         return limit !== undefined ? sorted.slice(0, limit) : sorted;
     }
     async getCeremoniesByDirection(direction) {
-        const data = await httpGet(`${this.baseUrl}/api/ceremonies?direction=${encodeURIComponent(direction)}`);
-        return data.ceremonies ?? [];
+        const url = `${this.baseUrl}/api/ceremonies?direction=${encodeURIComponent(direction)}`;
+        return readCollection(await httpGet(url), 'ceremonies', url);
     }
     async getCeremoniesByType(type) {
-        const data = await httpGet(`${this.baseUrl}/api/ceremonies?type=${encodeURIComponent(type)}`);
-        return data.ceremonies ?? [];
+        const url = `${this.baseUrl}/api/ceremonies?type=${encodeURIComponent(type)}`;
+        return readCollection(await httpGet(url), 'ceremonies', url);
     }
     // === Beats ===
     createBeat(beat) {
-        httpPost(`${this.baseUrl}/api/narrative/beats`, beat).catch(err => console.error(`[http-store] createBeat failed: ${err}`));
+        const url = `${this.baseUrl}/api/narrative/beats`;
+        return this.track('createBeat', url, httpPost(url, beat));
     }
     async getBeat(id) {
         const all = await this.getAllBeats();
         return all.find(b => b.id === id);
     }
     async getAllBeats(limit) {
-        const beats = await httpGet(`${this.baseUrl}/api/narrative/beats`);
+        const url = `${this.baseUrl}/api/narrative/beats`;
+        const beats = readCollection(await httpGet(url), 'beats', url);
         return limit !== undefined ? beats.slice(0, limit) : beats;
     }
     async getBeatsByDirection(direction) {
@@ -180,14 +306,19 @@ export class HttpStore {
     }
     // === Cycles ===
     createCycle(cycle) {
-        httpPost(`${this.baseUrl}/api/narrative/cycles`, cycle).catch(err => console.error(`[http-store] createCycle failed: ${err}`));
+        const url = `${this.baseUrl}/api/narrative/cycles`;
+        return this.track('createCycle', url, httpPost(url, cycle));
+    }
+    async listCycles() {
+        const url = `${this.baseUrl}/api/narrative/cycles`;
+        return readCollection(await httpGet(url), 'cycles', url);
     }
     async getCycle(id) {
-        const all = await httpGet(`${this.baseUrl}/api/narrative/cycles`);
+        const all = await this.listCycles();
         return all.find(c => c.id === id);
     }
     async getAllCycles() {
-        const all = await httpGet(`${this.baseUrl}/api/narrative/cycles`);
+        const all = await this.listCycles();
         return {
             active: all.filter(c => !c.archived),
             archived: all.filter(c => c.archived),
@@ -195,62 +326,59 @@ export class HttpStore {
     }
     archiveCycle(id) {
         // No dedicated archive endpoint — fetch, mark archived, and re-post
-        (async () => {
-            try {
-                const all = await httpGet(`${this.baseUrl}/api/narrative/cycles`);
-                const cycle = all.find(c => c.id === id);
-                if (cycle) {
-                    await httpPost(`${this.baseUrl}/api/narrative/cycles`, {
-                        ...cycle,
-                        archived: true,
-                    });
-                }
-            }
-            catch (err) {
-                console.error(`[http-store] archiveCycle failed: ${err}`);
-            }
-        })();
+        const url = `${this.baseUrl}/api/narrative/cycles`;
+        return this.track('archiveCycle', url, (async () => {
+            const all = await this.listCycles();
+            const cycle = all.find(c => c.id === id);
+            // An archive that found nothing to archive is a failed archive. Reported
+            // as success it tells the circle a cycle was closed that is still open.
+            if (!cycle)
+                throw new HttpStoreError(`archiveCycle: cycle ${id} not found`, url, 404);
+            await httpPost(url, { ...cycle, archived: true });
+        })());
     }
     // === Charts ===
-    // No server endpoint exists yet — these use a fallback pattern
-    // that logs a warning and returns empty results.
+    // A deployment may predate /api/charts. That absence (404) is a fact worth
+    // degrading over; a 500, a timeout or an HTML page is not, and returning []
+    // for those tells the caller "no charts exist" when the truth is unknown.
     saveChart(chart) {
-        httpPost(`${this.baseUrl}/api/charts`, chart).catch(err => console.error(`[http-store] saveChart: /api/charts not available — ${err}`));
+        const url = `${this.baseUrl}/api/charts`;
+        return this.track('saveChart', url, httpPost(url, chart));
     }
     async getChart(id) {
-        try {
-            const all = await this.getAllCharts();
-            return all.find(c => c.id === id);
-        }
-        catch {
-            console.error(`[http-store] getChart: /api/charts not available`);
-            return undefined;
-        }
+        const all = await this.getAllCharts();
+        return all.find(c => c.id === id);
     }
     async getAllCharts(direction) {
+        const url = `${this.baseUrl}/api/charts`;
+        let charts;
         try {
-            const charts = await httpGet(`${this.baseUrl}/api/charts`);
-            let result = Array.isArray(charts) ? charts : [];
-            if (direction)
-                result = result.filter(c => c.direction === direction);
-            return result.sort((a, b) => Date.parse(b.updated_at) - Date.parse(a.updated_at));
+            charts = readCollection(await httpGet(url), 'charts', url);
         }
-        catch {
-            console.error(`[http-store] getAllCharts: /api/charts not available`);
+        catch (error) {
+            if (!isEndpointMissing(error))
+                throw error;
+            console.error(`[http-store] getAllCharts: ${url} not available`);
             return [];
         }
+        const result = direction ? charts.filter(c => c.direction === direction) : [...charts];
+        return result.sort((a, b) => Date.parse(b.updated_at) - Date.parse(a.updated_at));
     }
     // === MMOT ===
     saveMmot(mmot) {
-        httpPost(`${this.baseUrl}/api/mmots`, mmot).catch(err => console.error(`[http-store] saveMmot: /api/mmots not available — ${err}`));
+        const url = `${this.baseUrl}/api/mmots`;
+        return this.track('saveMmot', url, httpPost(url, mmot));
     }
     async getMmotsByChart(chartId) {
+        const url = `${this.baseUrl}/api/mmots`;
         try {
-            const all = await httpGet(`${this.baseUrl}/api/mmots`);
-            return (Array.isArray(all) ? all : []).filter(m => m.chart_id === chartId);
+            const all = readCollection(await httpGet(url), 'mmots', url);
+            return all.filter(m => m.chart_id === chartId);
         }
-        catch {
-            console.error(`[http-store] getMmotsByChart: /api/mmots not available`);
+        catch (error) {
+            if (!isEndpointMissing(error))
+                throw error;
+            console.error(`[http-store] getMmotsByChart: ${url} not available`);
             return [];
         }
     }
@@ -273,8 +401,8 @@ export class HttpStore {
         if (filters.artefact !== undefined)
             params.set('artefact', filters.artefact);
         const query = params.size > 0 ? `?${params.toString()}` : '';
-        const data = await httpGet(`${this.baseUrl}/api/inquiry-weaves${query}`);
-        return data.inquiry_weaves ?? [];
+        const url = `${this.baseUrl}/api/inquiry-weaves${query}`;
+        return readCollection(await httpGet(url), 'inquiry_weaves', url);
     }
     // === Plan Perspectives ===
     async registerPlanPerspective(record) {
@@ -282,13 +410,15 @@ export class HttpStore {
         return data.record ?? record;
     }
     async getPlanPerspective(id) {
-        const res = await fetch(`${this.baseUrl}/api/plan-perspectives/${encodeURIComponent(id)}`);
+        const url = `${this.baseUrl}/api/plan-perspectives/${encodeURIComponent(id)}`;
+        const res = await httpFetch(url);
         if (res.status === 404)
             return undefined;
         if (!res.ok) {
-            throw new Error(`HTTP GET /api/plan-perspectives/${id} failed: ${res.status} ${res.statusText}`);
+            const text = await res.text().catch(() => '');
+            throw new HttpStoreError(`HTTP GET ${url} failed: ${res.status} ${res.statusText} — ${snippet(text)}`, url, res.status);
         }
-        const data = (await res.json());
+        const data = (await readJson(res, url, 'GET'));
         return data.record ?? undefined;
     }
     async listPlanPerspectives(filters = {}) {
@@ -300,8 +430,8 @@ export class HttpStore {
         if (filters.id !== undefined)
             params.set('id', filters.id);
         const query = params.size > 0 ? `?${params.toString()}` : '';
-        const data = await httpGet(`${this.baseUrl}/api/plan-perspectives${query}`);
-        return data.plan_perspectives ?? [];
+        const url = `${this.baseUrl}/api/plan-perspectives${query}`;
+        return readCollection(await httpGet(url), 'plan_perspectives', url);
     }
 }
 // ── Factory ──