@bpmsoftwaresolutions/ai-engine-client 1.0.0-beta.5 → 1.0.0-beta.6

package/README.md

@@ -174,6 +174,9 @@ const client = AIEngineClient.fromEnv();
 | `listProjects({ limit, includeInactive, processStatus, charterStatus })` | List projects. |
 | `getProject(projectId)` | Get project detail. |
 | `getProjectCharterReport(projectId)` | Get the SQL-backed charter report payload for a project. |
+| `createProjectMarkdownDownload(projectId, { reportType, includeMarkdown })` | Create a markdown download descriptor for `charter` or `implementation_roadmap`. |
+| `downloadProjectMarkdownReport(projectId, reportType)` | Download a rendered markdown report as text plus filename metadata. |
+| `downloadProjectCharterReportMarkdown(projectId)` | Download the charter markdown report. |
 | `getProjectBundle(projectId)` | Get current status, charter report, and roadmap report in one payload. |
 
 ### Roadmaps
@@ -184,6 +187,7 @@ const client = AIEngineClient.fromEnv();
 | `getProjectRoadmapSummary(projectId)` | Roadmap summary. |
 | `getProjectRoadmapActiveItem(projectId)` | Current active roadmap item. |
 | `getProjectImplementationRoadmapReport(projectId)` | Get the SQL-backed implementation roadmap report payload. |
+| `downloadProjectImplementationRoadmapReportMarkdown(projectId)` | Download the implementation roadmap markdown report. |
 | `ensureProjectRoadmapTaskSurface(projectId, { requestedBy, assignedTo, createAcceptanceSubtasks })` | Materialize the active roadmap item's parent task and acceptance subtasks. |
 | `listProjectOpenTasks(projectId)` | Open tasks for a project. |
 | `getProjectPerformanceMetrics(projectId, { workflowId, workflowRunId, sinceUtc })` | Performance metrics. |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bpmsoftwaresolutions/ai-engine-client",
-  "version": "1.0.0-beta.5",
+  "version": "1.0.0-beta.6",
   "description": "Thin npm client for the AI Engine operator and retrieval APIs",
   "type": "module",
   "main": "./src/index.js",

package/src/index.js

@@ -20,6 +20,14 @@ async function readJson(response) {
   return { message: text };
 }
 
+function parseContentDispositionFilename(headerValue) {
+  const value = String(headerValue || '');
+  const quotedMatch = value.match(/filename="([^"]+)"/i);
+  if (quotedMatch) return quotedMatch[1];
+  const plainMatch = value.match(/filename=([^;]+)/i);
+  return plainMatch ? plainMatch[1].trim() : null;
+}
+
 export class AIEngineClient {
   constructor({ baseUrl, apiKey, actorId, fetchImpl, timeoutMs } = {}) {
     if (!baseUrl) throw new Error('baseUrl is required.');
@@ -482,6 +490,21 @@ export class AIEngineClient {
     return this._request(`/api/operator/projects/${projectId}/charter/report`);
   }
 
+  async createProjectMarkdownDownload(projectId, { reportType, includeMarkdown = false } = {}) {
+    return this._request(`/api/operator/projects/${projectId}/markdown-report-downloads`, {
+      method: 'POST',
+      body: { report_type: reportType, include_markdown: includeMarkdown },
+    });
+  }
+
+  async downloadProjectMarkdownReport(projectId, reportType) {
+    return this._requestText(`/api/operator/projects/${projectId}/markdown-reports/${reportType}/download`);
+  }
+
+  async downloadProjectCharterReportMarkdown(projectId) {
+    return this.downloadProjectMarkdownReport(projectId, 'charter');
+  }
+
   async getProjectBundle(projectId) {
     return this._request(`/api/operator/projects/${projectId}/bundle`);
   }
@@ -510,6 +533,10 @@ export class AIEngineClient {
     return this._request(`/api/operator/projects/${projectId}/implementation-roadmap/report`);
   }
 
+  async downloadProjectImplementationRoadmapReportMarkdown(projectId) {
+    return this.downloadProjectMarkdownReport(projectId, 'implementation_roadmap');
+  }
+
   async ensureProjectRoadmapTaskSurface(projectId, {
     requestedBy,
     assignedTo,
@@ -1110,6 +1137,44 @@ export class AIEngineClient {
       clearTimeout(timeoutHandle);
     }
   }
+
+  async _requestText(path, { method = 'GET', query, headers, body } = {}) {
+    const url = appendQuery(`${this.baseUrl}${path}`, query);
+    const controller = new AbortController();
+    const timeoutHandle = setTimeout(() => controller.abort(), this.timeoutMs);
+    try {
+      const response = await this.fetchImpl(url, {
+        method,
+        headers: {
+          accept: 'text/markdown, text/plain;q=0.9, application/json;q=0.8',
+          'content-type': body ? 'application/json' : undefined,
+          'x-actor-id': this.actorId,
+          authorization: this.apiKey ? `Bearer ${this.apiKey}` : undefined,
+          ...headers,
+        },
+        body: body ? JSON.stringify(body) : undefined,
+        signal: controller.signal,
+      });
+      const contentType = response.headers.get('content-type') || '';
+      const contentDisposition = response.headers.get('content-disposition') || '';
+      if (!response.ok) {
+        const payload = contentType.includes('application/json')
+          ? await response.json()
+          : { message: await response.text() };
+        const error = new Error(payload?.message || payload?.error || `Request failed with status ${response.status}.`);
+        error.status = response.status;
+        error.payload = payload;
+        throw error;
+      }
+      return {
+        text: await response.text(),
+        contentType,
+        fileName: parseContentDispositionFilename(contentDisposition),
+      };
+    } finally {
+      clearTimeout(timeoutHandle);
+    }
+  }
 }
 
 export function createAIEngineClient(options) {