@hiai-gg/docsmint 0.4.3 → 0.4.4

package/dist/pipeline-cancellation.d.ts

@@ -0,0 +1,21 @@
+export type CancellablePipelineJob = Readonly<{
+    data?: Readonly<{
+        ownerId?: string;
+    }>;
+    getState(): Promise<string>;
+    remove(): Promise<void>;
+}>;
+export type AccountPipelineQueue = Readonly<{
+    getJobs(states?: string[]): Promise<readonly CancellablePipelineJob[]>;
+}>;
+export type AccountPipelineCancellationDependencies = Readonly<{
+    /** Atomically changes every non-terminal run owned by the actor to cancelled. */
+    cancelRuns(actorUserId: string, signal?: AbortSignal): Promise<number>;
+    queues: readonly AccountPipelineQueue[];
+}>;
+/**
+ * Fence active work durably, then remove only queue entries whose payload has
+ * exact actor ownership metadata. BullMQ active jobs cannot be removed safely;
+ * workers observe the durable fence before every write instead.
+ */
+export declare function cancelAccountPipelineJobs(actorUserId: string, deps: AccountPipelineCancellationDependencies, signal?: AbortSignal): Promise<number>;

package/dist/pipeline-cancellation.js

@@ -0,0 +1,34 @@
+const REMOVABLE_STATES = ["waiting", "delayed", "paused", "prioritized"];
+/**
+ * Fence active work durably, then remove only queue entries whose payload has
+ * exact actor ownership metadata. BullMQ active jobs cannot be removed safely;
+ * workers observe the durable fence before every write instead.
+ */
+export async function cancelAccountPipelineJobs(actorUserId, deps, signal) {
+    if (signal?.aborted)
+        throw signal.reason ?? new DOMException("Aborted", "AbortError");
+    let affected = await deps.cancelRuns(actorUserId, signal);
+    for (const queue of deps.queues) {
+        const jobs = await queue.getJobs([...REMOVABLE_STATES]);
+        for (const job of jobs) {
+            if (job.data?.ownerId !== actorUserId)
+                continue;
+            const state = await job.getState();
+            if (!REMOVABLE_STATES.includes(state))
+                continue;
+            try {
+                await job.remove();
+                affected += 1;
+            }
+            catch (error) {
+                // A worker may claim/remove the job between state inspection and remove.
+                // The durable run fence still prevents any subsequent write. BullMQ
+                // reports these two expected claim/removal races as explicit messages.
+                const message = error instanceof Error ? error.message.toLowerCase() : "";
+                if (!message.includes("not found") && !message.includes("locked") && !message.includes("active"))
+                    throw error;
+            }
+        }
+    }
+    return affected;
+}

package/package.json

@@ -1,14 +1,16 @@
 {
   "name": "@hiai-gg/docsmint",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "type": "module",
   "browser": {
     "./dist/backend-launcher.js": false,
     "./dist/lifecycle.js": false,
     "./dist/lifecycle-persistent.js": false,
     "./dist/lifecycle-runtime.js": false,
+    "./dist/pipeline-cancellation.js": false,
     "./dist/storage-quota.js": false,
-    "./dist/workspace.js": false
+    "./dist/workspace.js": false,
+    "./dist/backend-pipeline-cancellation.js": false
   },
   "license": "Apache-2.0",
   "description": "The lightweight, AI-native self-hosted knowledge base — built-in RAG, hybrid semantic search, and a clean REST API for AI agents.",
@@ -65,6 +67,11 @@
       "import": "./dist/lifecycle-runtime.js",
       "types": "./dist/lifecycle-runtime.d.ts"
     },
+    "./pipeline/cancellation": {
+      "browser": "./dist/server-only-browser-entry.js",
+      "import": "./dist/pipeline-cancellation.js",
+      "types": "./dist/pipeline-cancellation.d.ts"
+    },
     "./workspace": {
       "browser": "./dist/server-only-browser-entry.js",
       "import": "./dist/workspace.js",
@@ -294,6 +301,11 @@
     "./backend/lib/logger": {
       "import": "./backend/src/lib/logger.ts",
       "types": "./backend/src/lib/logger.ts"
+    },
+    "./backend/pipeline-cancellation": {
+      "browser": "./dist/server-only-browser-entry.js",
+      "import": "./dist/backend-pipeline-cancellation.js",
+      "types": "./dist/backend-pipeline-cancellation.d.ts"
     }
   },
   "bin": {
@@ -338,6 +350,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.1",
+    "bullmq": "^5.80.2",
     "commander": "^13.1.0",
     "zod": "^4.0.0"
   },

package/packages/cli/src/index.ts

@@ -24,7 +24,7 @@ import { registerSearch } from "./commands/search.js";
 import { registerSnapshot } from "./commands/snapshot.js";
 import { registerUpdate } from "./commands/update.js";
 
-const VERSION = "0.4.3";
+const VERSION = "0.4.4";
 
 const program = new Command();
 program

package/packages/mcp-server/src/index.ts

@@ -35,7 +35,7 @@ interface McpToolResult {
 
 const server = new McpServer({
 	name: "hiai-docs",
-	version: "0.4.3",
+	version: "0.4.4",
 });
 
 /**