gangtise-openapi-cli 0.41.1 → 0.43.0

package/dist/src/core/endpoints.js

@@ -25,13 +25,16 @@ const ENDPOINT_DEFS = {
         path: "/application/open-insight/chief-opinion/v2/getList",
         kind: "json",
         description: "List domestic institution chief opinions (brief only; body via detail)",
+        billing: { per: "row", price: 1 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "chiefOpinionId",
     },
     "insight.opinion.list-with-content": {
         method: "POST",
         path: "/application/open-insight/chief-opinion/getList",
         kind: "json",
         description: "List domestic institution chief opinions with the full body (v1 list)",
+        billing: { per: "row", price: 30 },
         pagination: { enabled: true, maxPageSize: 50 },
         retry: "no-replay",
     },
@@ -40,20 +43,25 @@ const ENDPOINT_DEFS = {
         path: "/application/open-insight/chief-opinion/getDetail",
         kind: "json",
         description: "Get domestic chief opinion bodies by ID (max 20 IDs per call)",
+        billing: { per: "row", price: 30, maxUnits: 20 },
         retry: "no-replay",
+        expects: "array",
     },
     "insight.summary.list": {
         method: "POST",
         path: "/application/open-insight/summary/v2/getList",
         kind: "json",
         description: "List summaries",
+        billing: { per: "row", price: 0.1 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "summaryId",
     },
     "insight.summary.download": {
         method: "GET",
         path: "/application/open-insight/summary/v2/download/file",
         kind: "download",
         description: "Download summary file",
+        billing: { per: "document", price: 50 },
         retry: "no-replay",
     },
     "insight.pamirs-summary.list": {
@@ -62,6 +70,7 @@ const ENDPOINT_DEFS = {
         kind: "json",
         description: "List Pamirs expert summaries (requires the expert-summary database)",
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "summaryId",
     },
     "insight.pamirs-summary.download": {
         method: "GET",
@@ -75,67 +84,88 @@ const ENDPOINT_DEFS = {
         path: "/application/open-insight/schedule/roadshow/getList",
         kind: "json",
         description: "List roadshows",
+        billing: { per: "row", price: 20 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "id",
+        rowIdUnverified: true,
     },
     "insight.site-visit.list": {
         method: "POST",
         path: "/application/open-insight/schedule/site-visit/getList",
         kind: "json",
         description: "List site visits",
+        billing: { per: "row", price: 20 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "id",
+        rowIdUnverified: true,
     },
     "insight.strategy.list": {
         method: "POST",
         path: "/application/open-insight/schedule/strategy-meeting/getList",
         kind: "json",
         description: "List strategy meetings",
+        billing: { per: "row", price: 20 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "id",
+        rowIdUnverified: true,
     },
     "insight.forum.list": {
         method: "POST",
         path: "/application/open-insight/schedule/forum/getList",
         kind: "json",
         description: "List forums",
+        billing: { per: "row", price: 20 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "id",
+        rowIdUnverified: true,
     },
     "insight.performance-calendar.list": {
         method: "POST",
         path: "/application/open-insight/schedule/performance-calendar/getList",
         kind: "json",
         description: "List earnings calendar events (forecast / express / announcement)",
+        billing: { per: "row", price: 0.1 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "performanceReportId",
     },
     "insight.performance-calendar.download": {
         method: "GET",
         path: "/application/open-insight/schedule/performance-calendar/download/file",
         kind: "download",
         description: "Download an earnings report file (A-share 10 credits, HK/US 20)",
+        billing: { per: "document", price: 20 },
     },
     "insight.research.list": {
         method: "POST",
         path: "/application/open-insight/broker-report/getList",
         kind: "json",
         description: "List broker research reports",
+        billing: { per: "row", price: 0.1 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "reportId",
     },
     "insight.research.download": {
         method: "GET",
         path: "/application/open-insight/broker-report/download/file",
         kind: "download",
         description: "Download broker research report",
+        billing: { per: "document", price: 10 },
     },
     "insight.foreign-report.list": {
         method: "POST",
         path: "/application/open-insight/foreign-report/getList",
         kind: "json",
         description: "List foreign reports",
+        billing: { per: "row", price: 0.1 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "reportId",
     },
     "insight.foreign-report.download": {
         method: "GET",
         path: "/application/open-insight/foreign-report/download/file",
         kind: "download",
         description: "Download foreign report",
+        billing: { per: "document", price: 50 },
         retry: "no-replay",
     },
     "insight.announcement.list": {
@@ -143,52 +173,64 @@ const ENDPOINT_DEFS = {
         path: "/application/open-insight/announcement/getList",
         kind: "json",
         description: "List A-share announcements",
+        billing: { per: "row", price: 0.1 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "announcementId",
     },
     "insight.announcement.download": {
         method: "GET",
         path: "/application/open-insight/announcement/download/file",
         kind: "download",
         description: "Download A-share announcement file",
+        billing: { per: "document", price: 10 },
     },
     "insight.announcement-hk.list": {
         method: "POST",
         path: "/application/open-insight/announcement-hk/getList",
         kind: "json",
         description: "List HK announcements",
+        billing: { per: "row", price: 0.1 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "announcementId",
     },
     "insight.announcement-hk.download": {
         method: "GET",
         path: "/application/open-insight/announcement-hk/download/file",
         kind: "download",
         description: "Download HK announcement file",
+        billing: { per: "document", price: 20 },
     },
     "insight.announcement-us.list": {
         method: "POST",
         path: "/application/open-insight/announcement-us/getList",
         kind: "json",
         description: "List US announcements",
+        billing: { per: "row", price: 0.1 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "announcementId",
     },
     "insight.announcement-us.download": {
         method: "GET",
         path: "/application/open-insight/announcement-us/download/file",
         kind: "download",
         description: "Download US announcement file",
+        billing: { per: "document", price: 20 },
     },
     "insight.foreign-opinion.list": {
         method: "POST",
         path: "/application/open-insight/foreign-opinion/v2/getList",
         kind: "json",
         description: "List foreign institution opinions (brief only; body via detail)",
+        billing: { per: "row", price: 1 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "foreignOpinionId",
     },
     "insight.foreign-opinion.list-with-content": {
         method: "POST",
         path: "/application/open-insight/foreign-opinion/getList",
         kind: "json",
         description: "List foreign institution opinions with the full body (v1 list)",
+        billing: { per: "row", price: 30 },
         pagination: { enabled: true, maxPageSize: 50 },
         retry: "no-replay",
     },
@@ -197,39 +239,49 @@ const ENDPOINT_DEFS = {
         path: "/application/open-insight/foreign-opinion/getDetail",
         kind: "json",
         description: "Get foreign opinion bodies by ID (max 20 IDs per call)",
+        billing: { per: "row", price: 30, maxUnits: 20 },
         retry: "no-replay",
+        expects: "array",
     },
     "insight.independent-opinion.list": {
         method: "POST",
         path: "/application/open-insight/independent-opinion/getList",
         kind: "json",
         description: "List foreign independent analyst opinions",
+        billing: { per: "row", price: 5 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "independentOpinionId",
+        rowIdUnverified: true,
     },
     "insight.independent-opinion.download": {
         method: "GET",
         path: "/application/open-insight/independent-opinion/download/file",
         kind: "download",
         description: "Download foreign independent opinion file",
+        billing: { per: "document", price: 30 },
     },
     "insight.official-account.list": {
         method: "POST",
         path: "/application/open-insight/officialAccount/getList",
         kind: "json",
         description: "List WeChat official account articles",
+        billing: { per: "row", price: 0.1 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "articleId",
     },
     "insight.official-account.download": {
         method: "GET",
         path: "/application/open-insight/officialAccount/download/file",
         kind: "download",
         description: "Download WeChat official account article (txt/HTML)",
+        billing: { per: "document", price: 10 },
     },
     "insight.qa.list": {
         method: "POST",
         path: "/application/open-insight/Q&A-data/getList",
         kind: "json",
         description: "List investor Q&A (conference/interactive/survey) for a security",
+        billing: { per: "row", price: 0.1 },
         pagination: { enabled: true, maxPageSize: 500 },
     },
     "insight.report-image.list": {
@@ -243,7 +295,9 @@ const ENDPOINT_DEFS = {
         path: "/application/open-insight/summary/highlight/getList",
         kind: "json",
         description: "List meeting highlights (核心要点信息流; content is an HTML fragment)",
+        billing: { per: "row", price: 5 },
         pagination: { enabled: true, maxPageSize: 50, maxWindow: 10000 },
+        rowId: "highlightId",
         retry: "no-replay",
         expects: "list",
     },
@@ -252,6 +306,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-insight/report-image/download/file",
         kind: "download",
         description: "Download a research report image by chunkId",
+        billing: { per: "document", price: 0.1 },
     },
     "reference.securities-search": {
         method: "POST",
@@ -433,6 +488,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-fundamental/valuation-analysis",
         kind: "json",
         description: "Query valuation analysis",
+        expects: "list",
     },
     "fundamental.top-holders": {
         method: "POST",
@@ -445,12 +501,15 @@ const ENDPOINT_DEFS = {
         path: "/application/open-fundamental/earning-forecast",
         kind: "json",
         description: "Query earning forecast (consensus estimates)",
+        billing: { per: "row", price: 0.5, maxUnits: Number.POSITIVE_INFINITY },
+        retry: "no-replay",
     },
     "bond.basic-info": {
         method: "POST",
         path: "/application/open-fundamental/bond/basic-info",
         kind: "json",
         description: "Query bond static profiles (issuance, term, coupon, rating, options)",
+        billing: { per: "call", price: 0.4 },
         retry: "no-replay",
         expects: "list",
     },
@@ -459,6 +518,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-fundamental/bond/issuer-info",
         kind: "json",
         description: "Query bond issuer profiles (by bond code or issuer name)",
+        billing: { per: "call", price: 0.4 },
         retry: "no-replay",
         expects: "list",
     },
@@ -467,6 +527,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-quote/bond/daily-quote-exchange-cfets",
         kind: "json",
         description: "Query bond daily close quotes (exchange + CFETS; dirty/clean price, YTM, duration)",
+        billing: { per: "call", price: 0.4 },
         retry: "no-replay",
         expects: "list",
     },
@@ -475,6 +536,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-fundamental/bond/valuation-shclearing",
         kind: "json",
         description: "Query Shanghai Clearing House bond valuations (price, yield, risk measures)",
+        billing: { per: "call", price: 0.4 },
         retry: "no-replay",
         expects: "list",
     },
@@ -483,6 +545,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-fundamental/bond/cash-flow",
         kind: "json",
         description: "Query bond interest payment and redemption schedule",
+        billing: { per: "call", price: 0.4 },
         retry: "no-replay",
         expects: "list",
     },
@@ -491,6 +554,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-fundamental/bond/announcement",
         kind: "json",
         description: "Query bond announcements (pageNo/pageSize; the only paged endpoint of the family)",
+        billing: { per: "call", price: 0.4 },
         retry: "no-replay",
         expects: "list",
     },
@@ -499,6 +563,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-fundamental/bond/issuance-detail",
         kind: "json",
         description: "Query bond issuance and re-issuance records (bidding, pricing, cover ratios)",
+        billing: { per: "call", price: 0.4 },
         retry: "no-replay",
         expects: "list",
     },
@@ -507,6 +572,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-fundamental/bond/rating-overview",
         kind: "json",
         description: "Query bond / issuer / guarantor ratings side by side (max 10 bonds per call)",
+        billing: { per: "call", price: 0.4 },
         retry: "no-replay",
         expects: "list",
     },
@@ -515,6 +581,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-fundamental/bond/rating-change",
         kind: "json",
         description: "Query bond rating change history (max 10 bonds per call)",
+        billing: { per: "call", price: 0.4 },
         retry: "no-replay",
         expects: "list",
     },
@@ -523,6 +590,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-fundamental/bond/issuer-rating-change",
         kind: "json",
         description: "Query issuer rating change history (by bond code or issuer name)",
+        billing: { per: "call", price: 0.4 },
         retry: "no-replay",
         expects: "list",
     },
@@ -531,6 +599,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-fundamental/bond/issuance-plan",
         kind: "json",
         description: "Query the rate-bond issuance calendar over a date range",
+        billing: { per: "call", price: 0.4 },
         retry: "no-replay",
         expects: "list",
     },
@@ -539,6 +608,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-fundamental/bond/exercise-notice",
         kind: "json",
         description: "Query put/call exercise schedules and results for option-embedded bonds",
+        billing: { per: "call", price: 0.4 },
         retry: "no-replay",
         expects: "list",
     },
@@ -547,12 +617,16 @@ const ENDPOINT_DEFS = {
         path: "/application/open-ai/stock-summary/getList",
         kind: "json",
         description: "Stock highlights (refined research summary per security)",
+        billing: { per: "row", price: 3, maxUnits: 6000 },
+        retry: "no-replay",
+        timeoutMs: 120_000,
     },
     "ai.knowledge-batch": {
         method: "POST",
         path: "/application/open-data/ai/search/knowledge/batch",
         kind: "json",
         description: "Batch knowledge search",
+        billing: { per: "call", price: 10 },
         retry: "no-replay",
     },
     "ai.knowledge-resource.download": {
@@ -566,6 +640,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-ai/security-clue/getList",
         kind: "json",
         description: "List security clues",
+        billing: { per: "row", price: 5 },
         pagination: { enabled: true, maxPageSize: 500 },
     },
     "ai.one-pager": {
@@ -573,6 +648,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-ai/agent/one-pager",
         kind: "json",
         description: "Generate one pager",
+        billing: { per: "call", price: 50 },
         timeoutMs: 120_000,
         retry: "no-replay",
     },
@@ -581,6 +657,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-ai/agent/investment-logic",
         kind: "json",
         description: "Generate investment logic",
+        billing: { per: "call", price: 50 },
         timeoutMs: 120_000,
         retry: "no-replay",
     },
@@ -589,6 +666,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-ai/agent/peer-comparison",
         kind: "json",
         description: "Generate peer comparison",
+        billing: { per: "call", price: 50 },
         timeoutMs: 120_000,
         retry: "no-replay",
     },
@@ -597,6 +675,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-ai/agent/earnings-review-getid",
         kind: "json",
         description: "Get earnings review ID",
+        billing: { per: "call", price: 50 },
         retry: "no-replay",
     },
     "ai.earnings-review.get-content": {
@@ -610,6 +689,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-ai/agent/theme-tracking",
         kind: "json",
         description: "Get theme tracking daily report",
+        billing: { per: "call", price: 50 },
         timeoutMs: 120_000,
         retry: "no-replay",
     },
@@ -618,6 +698,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-ai/agent/research-outline",
         kind: "json",
         description: "Get company research outline",
+        billing: { per: "call", price: 50 },
         timeoutMs: 120_000,
         retry: "no-replay",
     },
@@ -626,6 +707,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-ai/hot-topic/getList",
         kind: "json",
         description: "List hot topic reports",
+        billing: { per: "row", price: 50 },
         pagination: { enabled: true, maxPageSize: 20 },
         retry: "no-replay",
     },
@@ -634,6 +716,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-ai/management-discuss/from-announcement",
         kind: "json",
         description: "Management discussion from financial reports (half-year/annual)",
+        billing: { per: "call", price: 10 },
         timeoutMs: 120_000,
         retry: "no-replay",
     },
@@ -642,6 +725,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-ai/management-discuss/from-earningsCall",
         kind: "json",
         description: "Management discussion from earnings calls",
+        billing: { per: "call", price: 10 },
         timeoutMs: 120_000,
         retry: "no-replay",
     },
@@ -650,6 +734,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-ai/agent/viewpoint-debate-getid",
         kind: "json",
         description: "Get viewpoint debate ID",
+        billing: { per: "call", price: 50 },
         retry: "no-replay",
     },
     "ai.viewpoint-debate.get-content": {
@@ -664,6 +749,7 @@ const ENDPOINT_DEFS = {
         kind: "json",
         description: "List vault drive files",
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "fileId",
     },
     "vault.drive.download": {
         method: "GET",
@@ -742,6 +828,7 @@ const ENDPOINT_DEFS = {
         kind: "json",
         description: "List voice recording transcriptions",
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "recordId",
     },
     "vault.record.download": {
         method: "GET",
@@ -754,13 +841,16 @@ const ENDPOINT_DEFS = {
         path: "/application/open-vault/my-conference/getList",
         kind: "json",
         description: "List my conferences",
+        billing: { per: "row", price: 0.1 },
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "conferenceId",
     },
     "vault.my-conference.download": {
         method: "GET",
         path: "/application/open-vault/my-conference/download/file",
         kind: "download",
         description: "Download my conference resource",
+        billing: { per: "document", price: 50 },
         retry: "no-replay",
     },
     "vault.wechat-message.list": {
@@ -768,7 +858,8 @@ const ENDPOINT_DEFS = {
         path: "/application/open-vault/wechatgroupmsg/list",
         kind: "json",
         description: "List WeChat group messages",
-        pagination: { enabled: true, maxPageSize: 50 },
+        pagination: { enabled: true, maxPageSize: 50, maxWindow: 10000 },
+        rowId: "msgId",
     },
     "vault.wechat-chatroom.list": {
         method: "POST",
@@ -776,6 +867,7 @@ const ENDPOINT_DEFS = {
         kind: "json",
         description: "List WeChat group chatroom IDs",
         pagination: { enabled: true, maxPageSize: 50 },
+        rowId: "chatroomId",
     },
     "vault.stock-pool.list": {
         method: "POST",
@@ -841,6 +933,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-alternative/concept/v2/info",
         kind: "json",
         description: "Query latest concept (theme index) profile by conceptId",
+        billing: { per: "call", price: 50 },
         retry: "no-replay",
     },
     "alternative.concept-info-full": {
@@ -848,6 +941,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-alternative/concept/info",
         kind: "json",
         description: "Query latest concept profile incl. catalyst events (keyEvents; v1)",
+        billing: { per: "call", price: 500 },
         retry: "no-replay",
     },
     "alternative.concept-securities": {
@@ -855,6 +949,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-alternative/concept/v2/securities",
         kind: "json",
         description: "Query concept (theme index) constituent securities, grouped",
+        billing: { per: "call", price: 50 },
         retry: "no-replay",
     },
     "alternative.concept-securities-full": {
@@ -862,6 +957,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-alternative/concept/securities",
         kind: "json",
         description: "Query concept constituents incl. isKey / inclusionReason (v1)",
+        billing: { per: "call", price: 500 },
         retry: "no-replay",
     },
     "indicator.search": {
@@ -897,6 +993,7 @@ const ENDPOINT_DEFS = {
         path: "/application/open-tool/file-parse/submit",
         kind: "upload",
         description: "Submit a PDF for parsing (multipart upload), returns taskId",
+        billing: { per: "page", price: 0.8 },
         timeoutMs: 300_000,
         retry: "no-replay",
         bigIntFields: ["taskId"],
@@ -912,10 +1009,18 @@ const ENDPOINT_DEFS = {
         path: "/application/open-tool/web-search/search",
         kind: "json",
         description: "Search the public web for research (tiered sources, optional page content)",
+        billing: { per: "call", price: 1 },
         retry: "no-replay",
         expects: "list",
     },
 };
+export const NO_REPLAY_ABOVE_CREDITS = 3000;
+export function worstRequestCredits(endpoint) {
+    if (!endpoint.billing)
+        return 0;
+    const units = endpoint.pagination?.maxPageSize ?? endpoint.billing.maxUnits ?? 1;
+    return units * endpoint.billing.price;
+}
 export const ENDPOINTS = Object.fromEntries(Object.entries(ENDPOINT_DEFS).map(([key, def]) => [key, { key, ...def }]));
 export function listEndpoints() {
     return Object.values(ENDPOINTS).map(({ key, method, path, description }) => ({ key, method, path, description }));

package/dist/src/core/exitStatus.js

@@ -0,0 +1,17 @@
+export const EXIT_FAILED = 1;
+export const EXIT_INCOMPLETE = 3;
+export const EXIT_SUPERSEDED = 4;
+export function markFailed() {
+    process.exitCode = EXIT_FAILED;
+}
+export function markIncomplete() {
+    if (process.exitCode !== EXIT_FAILED)
+        process.exitCode = EXIT_INCOMPLETE;
+}
+export function markSuperseded() {
+    if (process.exitCode !== EXIT_FAILED && process.exitCode !== EXIT_INCOMPLETE)
+        process.exitCode = EXIT_SUPERSEDED;
+}
+export function decidedExitCode() {
+    return Number(process.exitCode ?? 0);
+}

package/dist/src/core/fileParse.js

@@ -1,9 +1,8 @@
 import fs from "node:fs/promises";
 import path from "node:path";
-import { isAsyncPending, nextPollDelayMs, POLL_MAX_ATTEMPTS } from "./asyncContent.js";
+import { isAsyncPending, pollUntilDone } from "./asyncContent.js";
 import { saveDownloadResult } from "./download.js";
 import { ApiError, ValidationError } from "./errors.js";
-import { isTransientError } from "./transport.js";
 export const FILE_PARSE_MAX_BYTES = 100 * 1024 * 1024;
 export async function submitFileParse(client, filePath) {
     const resolved = path.resolve(filePath);
@@ -50,22 +49,6 @@ export async function fetchFileParseResult(client, taskId, output) {
     return "ok";
 }
 export async function pollFileParseResult(client, taskId, output) {
-    for (let attempt = 1; attempt <= POLL_MAX_ATTEMPTS; attempt++) {
-        try {
-            if (await fetchFileParseResult(client, taskId, output) === "ok")
-                return "ok";
-        }
-        catch (error) {
-            if (!isTransientError(error))
-                throw error;
-            const msg = error instanceof Error ? error.message : String(error);
-            process.stderr.write(`Attempt ${attempt}/${POLL_MAX_ATTEMPTS}: transient error (${msg.slice(0, 80)}), continuing to wait...\n`);
-        }
-        if (attempt < POLL_MAX_ATTEMPTS) {
-            const delay = nextPollDelayMs(attempt);
-            process.stderr.write(`Attempt ${attempt}/${POLL_MAX_ATTEMPTS}: parse result not ready, retrying in ${Math.round(delay / 1000)}s...\n`);
-            await new Promise(resolve => setTimeout(resolve, delay));
-        }
-    }
-    return "timeout";
+    const outcome = await pollUntilDone(async () => await fetchFileParseResult(client, taskId, output), "parse result not ready");
+    return outcome === "ok" ? "ok" : "timeout";
 }

package/dist/src/core/opinionDetail.js

@@ -0,0 +1,39 @@
+import { ApiError, ValidationError } from "./errors.js";
+export async function fetchOpinionDetails(client, endpointKey, idListField, idField, ids) {
+    const BATCH = 20;
+    const unique = [...new Set(ids)];
+    if (!unique.length)
+        throw new ValidationError("pass at least one opinion ID");
+    const list = [];
+    let unfetched = [];
+    let unfetchedError;
+    for (let i = 0; i < unique.length; i += BATCH) {
+        try {
+            const rows = await client.call(endpointKey, { [idListField]: unique.slice(i, i + BATCH) });
+            list.push(...rows);
+        }
+        catch (error) {
+            if (i === 0)
+                throw error;
+            unfetched = unique.slice(i);
+            const message = error instanceof Error ? error.message : String(error);
+            unfetchedError = { message, ...(error instanceof ApiError ? { code: error.code, traceId: error.traceId } : {}) };
+            process.stderr.write(`[gangtise] warning: ${endpointKey} failed on batch ${i / BATCH + 1} (${message}); ${unfetched.length} ID(s) not fetched: ${unfetched.join(", ")}. The bodies already returned are kept below — re-run for the IDs in unfetchedIds only.\n`);
+            break;
+        }
+    }
+    const returned = new Set(list.map((row) => String(row[idField])));
+    const missing = unique.filter((id) => !returned.has(id) && !unfetched.includes(id));
+    const out = { total: list.length, list };
+    if (missing.length > 0) {
+        process.stderr.write(`[gangtise] warning: no body returned for ${missing.length} ID(s): ${missing.join(", ")} — the server skips an ID it has no body for without an error (e.g. a wrong ID; a just-published opinion may also not have its body yet). Result marked partial (exit 3).\n`);
+        out.missingIds = missing;
+    }
+    if (unfetched.length > 0) {
+        out.unfetchedIds = unfetched;
+        out.unfetchedError = unfetchedError;
+    }
+    if (missing.length > 0 || unfetched.length > 0)
+        out.partial = true;
+    return out;
+}