@j0hanz/fetch-url-mcp 1.12.7 → 1.12.9

package/dist/lib/utils.js

@@ -1,12 +1,9 @@
 import { Buffer } from 'node:buffer';
 import { createHmac, timingSafeEqual } from 'node:crypto';
 import { setInterval as setIntervalPromise, setTimeout as setTimeoutPromise, } from 'node:timers/promises';
-import { inspect } from 'node:util';
-import { config, logDebug, logWarn } from './core.js';
-import { SystemErrors } from './error-codes.js';
-import { Loggers } from './logger-names.js';
+import { z } from 'zod';
+import { isAbortError } from './error/index.js';
 const textEncoder = new TextEncoder();
-const UNKNOWN_ERROR_MESSAGE = 'Unknown error';
 export function composeAbortSignal(signal, timeoutMs) {
     const timeoutSignal = timeoutMs && timeoutMs > 0 ? AbortSignal.timeout(timeoutMs) : undefined;
     if (signal && timeoutSignal) {
@@ -17,25 +14,6 @@ export function composeAbortSignal(signal, timeoutMs) {
 export function parseUrlOrNull(input, base) {
     return URL.parse(input, base);
 }
-export function throwIfAborted(signal, url, stage) {
-    if (!signal?.aborted)
-        return;
-    if (signal.reason instanceof Error && signal.reason.name === 'TimeoutError') {
-        const error = new FetchError('Request timeout', url, 504, {
-            reason: 'timeout',
-            stage,
-        });
-        throw error;
-    }
-    throw createAbortError(url, stage);
-}
-export function createAbortError(url, stage) {
-    const error = new FetchError('Request was canceled', url, 499, {
-        reason: 'aborted',
-        stage,
-    });
-    return error;
-}
 export function timingSafeEqualUtf8(a, b) {
     const aBuf = textEncoder.encode(a);
     const bBuf = textEncoder.encode(b);
@@ -46,119 +24,6 @@ export function timingSafeEqualUtf8(a, b) {
 export function hmacSha256Hex(key, input) {
     return createHmac('sha256', key).update(input).digest('hex');
 }
-const DEFAULT_HTTP_STATUS = 502;
-export class FetchError extends Error {
-    url;
-    statusCode;
-    code;
-    details;
-    constructor(message, url, httpStatus, details = {}, options) {
-        super(message, options);
-        this.url = url;
-        this.name = 'FetchError';
-        this.statusCode = httpStatus ?? DEFAULT_HTTP_STATUS;
-        this.details = Object.freeze({ url, httpStatus, ...details });
-        const explicitCode = this.details['code'];
-        if (typeof explicitCode === 'string') {
-            this.code = explicitCode;
-        }
-        else if (httpStatus) {
-            this.code = `HTTP_${httpStatus}`;
-        }
-        else {
-            this.code = SystemErrors.FETCH_ERROR;
-        }
-    }
-}
-export function getErrorMessage(error) {
-    if (isError(error))
-        return error.message;
-    if (typeof error === 'string' && error.length > 0)
-        return error;
-    if (isObject(error) &&
-        typeof error['message'] === 'string' &&
-        error['message'].length > 0) {
-        return error['message'];
-    }
-    if (error === null || error === undefined)
-        return UNKNOWN_ERROR_MESSAGE;
-    try {
-        return inspect(error, {
-            depth: 2,
-            maxStringLength: 200,
-            breakLength: Infinity,
-            compact: true,
-            colors: false,
-        });
-    }
-    catch {
-        return UNKNOWN_ERROR_MESSAGE;
-    }
-}
-export function toError(error) {
-    return isError(error) ? error : new Error(getErrorMessage(error));
-}
-export function isAbortError(error) {
-    return isError(error) && error.name === 'AbortError';
-}
-export class CodedError extends Error {
-    code;
-    constructor(message, code, options) {
-        super(message, options);
-        this.code = code;
-        this.name = 'CodedError';
-    }
-}
-export function isSystemError(error) {
-    if (!isError(error))
-        return false;
-    if (!('code' in error))
-        return false;
-    const { code } = error;
-    return typeof code === 'string';
-}
-const DROP_LOG_INTERVAL_MS = 10_000;
-export function applyHttpServerTuning(server) {
-    const { headersTimeoutMs, requestTimeoutMs, keepAliveTimeoutMs, keepAliveTimeoutBufferMs, maxHeadersCount, maxConnections, } = config.server.http;
-    if (headersTimeoutMs !== undefined)
-        server.headersTimeout = headersTimeoutMs;
-    if (requestTimeoutMs !== undefined)
-        server.requestTimeout = requestTimeoutMs;
-    if (keepAliveTimeoutMs !== undefined)
-        server.keepAliveTimeout = keepAliveTimeoutMs;
-    if (keepAliveTimeoutBufferMs !== undefined)
-        server.keepAliveTimeoutBuffer = keepAliveTimeoutBufferMs;
-    if (maxHeadersCount !== undefined)
-        server.maxHeadersCount = maxHeadersCount;
-    if (typeof maxConnections === 'number' && maxConnections > 0) {
-        server.maxConnections = maxConnections;
-        server.dropMaxConnection = true;
-        if (typeof server.on === 'function') {
-            let lastLoggedAt = 0;
-            let droppedSinceLastLog = 0;
-            const onDrop = (data) => {
-                droppedSinceLastLog += 1;
-                const now = Date.now();
-                if (now - lastLoggedAt < DROP_LOG_INTERVAL_MS)
-                    return;
-                logWarn('Incoming connection dropped (maxConnections reached)', {
-                    maxConnections,
-                    dropped: droppedSinceLastLog,
-                    data,
-                }, Loggers.LOG_HTTP);
-                lastLoggedAt = now;
-                droppedSinceLastLog = 0;
-            };
-            server.on('drop', onDrop);
-        }
-    }
-}
-export function drainConnectionsOnShutdown(server) {
-    if (typeof server.closeIdleConnections === 'function') {
-        server.closeIdleConnections();
-        logDebug('Closed idle HTTP connections during shutdown', undefined, Loggers.LOG_HTTP);
-    }
-}
 function createAbortSafeTimeoutPromise(timeoutMs, value, signal) {
     return setTimeoutPromise(timeoutMs, value, {
         ref: false,
@@ -207,15 +72,6 @@ export function isObject(value) {
 export function compactContext(obj) {
     return Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== undefined));
 }
-export function isError(value) {
-    const maybeIsError = Error.isError;
-    if (typeof maybeIsError === 'function') {
-        const result = maybeIsError(value);
-        if (typeof result === 'boolean')
-            return result;
-    }
-    return value instanceof Error;
-}
 export function isHtmlNode(value) {
     return (isObject(value) &&
         ('nodeType' in value || 'nodeName' in value || 'tagName' in value));
@@ -340,3 +196,29 @@ export function buildOptionalIcons(iconInfo) {
         ],
     };
 }
+function formatPathSegment(segment) {
+    if (typeof segment === 'number')
+        return `[${segment}]`;
+    if (typeof segment === 'string')
+        return segment;
+    return segment.description ?? '<symbol>';
+}
+function formatIssuePath(path) {
+    return path.reduce((acc, segment) => {
+        const isNum = typeof segment === 'number';
+        const formatted = formatPathSegment(segment);
+        return acc ? `${acc}${isNum ? '' : '.'}${formatted}` : formatted;
+    }, '');
+}
+export function formatZodError(error) {
+    const parts = error.issues.map((issue) => {
+        const path = formatIssuePath(issue.path);
+        return path ? `${path}: ${issue.message}` : issue.message;
+    });
+    const uniqueParts = [
+        ...new Set(parts.filter((val) => val.trim().length > 0)),
+    ];
+    if (uniqueParts.length > 0)
+        return uniqueParts.join('; ');
+    return z.prettifyError(error).replace(/\s+/g, ' ').trim() || 'Invalid input';
+}

package/dist/resources/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQzE,OAAO,EAAsB,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAIpE,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,QAAQ,GAClB,IAAI,CAwBN;AAED,eAAO,MAAM,WAAW,iEAKd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,wBAAgB,cAAc,CAC5B,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,SAAS,GACf,MAAM,GAAG,SAAS,CAIpB;AAED,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CAKR;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAgChD;AAiBD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,QAAQ,GAClB,IAAI,CA2BN"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,OAAO,EAAsB,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAOpE,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,QAAQ,GAClB,IAAI,CAwBN;AAED,eAAO,MAAM,WAAW,iEAKd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,wBAAgB,cAAc,CAC5B,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,SAAS,GACf,MAAM,GAAG,SAAS,CAIpB;AAED,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,CAKR;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAmChD;AAiBD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,QAAQ,GAClB,IAAI,CA2BN"}

package/dist/resources/index.js

@@ -1,8 +1,10 @@
 import { completable } from '@modelcontextprotocol/sdk/server/completable.js';
 import { z } from 'zod';
-import { config } from '../lib/core.js';
+import { config } from '../lib/config.js';
 import { buildOptionalIcons } from '../lib/utils.js';
-import { FETCH_URL_TOOL_NAME } from '../tools/fetch-url.js';
+import { FETCH_URL_TOOL_NAME } from '../tools/index.js';
+// Area contract: MCP resources and prompts for server guidance.
+// Export only assistant-facing help surfaces; keep tool execution and transport wiring out.
 export function registerInstructionResource(server, instructions, iconInfo) {
     server.registerResource('fetch-url-mcp-instructions', 'internal://instructions', {
         title: 'Server Instructions',
@@ -68,10 +70,13 @@ export function buildServerInstructions() {
 - Notifications: opt-in. Set \`TASKS_STATUS_NOTIFICATIONS=true\`.
 
 # Errors
-- SystemErrors.VALIDATION_ERROR: invalid/blocked URL. Do not retry.
-- SystemErrors.FETCH_ERROR: network failure. Retry once with backoff.
-- HTTP_xxx: upstream error. Retry only for 5xx.
-- SystemErrors.ABORTED: cancelled. Retry if needed.
+- VALIDATION_ERROR: invalid/blocked URL. Do not retry.
+- FETCH_ERROR: network failure. Retry once with backoff.
+- UPSTREAM_HTTP_ERROR: upstream HTTP error. Retry only for 5xx.
+- UPSTREAM_RATE_LIMITED: upstream returned 429. Back off and retry.
+- UPSTREAM_TIMEOUT: upstream request timed out. Retry with backoff.
+- UPSTREAM_ABORTED: request was cancelled. Retry if needed.
+- MCP_ERROR: internal protocol error. Do not retry.
 - queue_full: worker pool busy. Wait and retry, or use task mode.`;
 }
 function buildTopicSchema() {

package/dist/schemas.d.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import type { ExtractedMetadata } from './transform/types.js';
+import type { ExtractedMetadata } from './transform/index.js';
 export declare const extractedMetadataSchema: z.ZodType<ExtractedMetadata>;
 export declare function normalizeExtractedMetadata(value: unknown): ExtractedMetadata | undefined;
 export declare function normalizePageTitle(value: unknown): string | undefined;

package/dist/schemas.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { config } from './lib/core.js';
+import { config } from './lib/config.js';
 const URL_FIELD_MAX_LENGTH = 2048;
 const METADATA_LIMITS = {
     title: 512,

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAgHpE,wBAAsB,eAAe,IAAI,OAAO,CAAC,SAAS,CAAC,CAE1D;AAkDD,wBAAsB,6BAA6B,IAAI,OAAO,CAAC,SAAS,CAAC,CAExE;AAwHD,wBAAsB,gBAAgB,IAAI,OAAO,CAAC;IAChD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C,CAAC,CASD"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAgHpE,wBAAsB,eAAe,IAAI,OAAO,CAAC,SAAS,CAAC,CAE1D;AAkDD,wBAAsB,6BAA6B,IAAI,OAAO,CAAC,SAAS,CAAC,CAExE;AAwHD,wBAAsB,gBAAgB,IAAI,OAAO,CAAC;IAChD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C,CAAC,CASD"}

package/dist/server.js

@@ -1,17 +1,16 @@
-import * as fs from 'node:fs/promises';
-import process from 'node:process';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { SetLevelRequestSchema } from '@modelcontextprotocol/sdk/types.js';
-import { config } from './lib/core.js';
-import { getSessionId, logError, logInfo, logNotice, setLogLevel, setMcpServer, } from './lib/core.js';
-import { Loggers } from './lib/logger-names.js';
+import * as fs from 'node:fs/promises';
+import process from 'node:process';
+import { config } from './lib/config.js';
+import { getSessionId, logError, Loggers, logInfo, logNotice, setLogLevel, setMcpServer, } from './lib/core.js';
+import { toError } from './lib/error/index.js';
 import { setTaskToolCallCapability } from './lib/mcp-interop.js';
-import { toError } from './lib/utils.js';
 import { buildServerInstructions, registerGetHelpPrompt, registerInstructionResource, } from './resources/index.js';
-import { abortAllTaskExecutions, registerTaskHandlers, } from './tasks/handlers.js';
-import { registerTools as registerFetchUrlTool } from './tools/fetch-url.js';
-import { shutdownTransformWorkerPool } from './transform/transform.js';
+import { abortAllTaskExecutions, registerTaskHandlers } from './tasks/index.js';
+import { registerTools as registerFetchUrlTool } from './tools/index.js';
+import { shutdownTransformWorkerPool } from './transform/index.js';
 /* -------------------------------------------------------------------------------------------------
  * Icons + server info
  * ------------------------------------------------------------------------------------------------- */

package/dist/tasks/index.d.ts

@@ -0,0 +1,2 @@
+export * from './manager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tasks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tasks/index.ts"],"names":[],"mappings":"AAGA,cAAc,cAAc,CAAC"}

package/dist/tasks/index.js

@@ -0,0 +1,3 @@
+// Area contract: task subsystem entrypoint for async execution and MCP task handlers.
+// Export only task-facing APIs consumed outside tasks/; keep tool logic and transport-specific helpers out.
+export * from './manager.js';

package/dist/tasks/manager.d.ts

@@ -1,3 +1,46 @@
+import { type McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type ServerResult } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+import { type ProgressNotification, type ToolHandlerExtra } from '../lib/mcp-interop.js';
+export declare const extendedCallToolRequestSchema: z.ZodObject<{
+    method: z.ZodLiteral<"tools/call">;
+    params: z.ZodObject<{
+        name: z.ZodString;
+        arguments: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        task: z.ZodOptional<z.ZodObject<{
+            ttl: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>>;
+        _meta: z.ZodOptional<z.ZodObject<{
+            progressToken: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+            'io.modelcontextprotocol/related-task': z.ZodOptional<z.ZodObject<{
+                taskId: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$loose>>;
+    }, z.core.$strict>;
+}, z.core.$loose>;
+export type ExtendedCallToolRequest = z.infer<typeof extendedCallToolRequestSchema>;
+export type ToolCallRequestMeta = ExtendedCallToolRequest['params']['_meta'];
+export declare function parseExtendedCallToolRequest(request: unknown): ExtendedCallToolRequest;
+export declare function sanitizeToolCallMeta(meta?: ToolCallRequestMeta): ToolCallRequestMeta | undefined;
+export declare function buildRelatedTaskMeta(taskId: string, meta?: ToolCallRequestMeta): Record<string, unknown>;
+export declare function withRelatedTaskMeta(result: ServerResult, taskId: string): ServerResult;
+export declare function abortTaskExecution(taskId: string): void;
+export declare function cancelTasksForOwner(ownerKey: string, statusMessage?: string): number;
+export declare function abortAllTaskExecutions(): void;
+type TaskSummary = CreateTaskResult['task'];
+type TaskLifecycleProjection = Pick<TaskState, 'taskId' | 'status' | 'statusMessage' | 'progress' | 'total' | 'createdAt' | 'lastUpdatedAt' | 'ttl' | 'pollInterval'>;
+export declare function toTaskSummary(task: TaskLifecycleProjection): TaskSummary;
+export declare function emitTaskStatusNotification(server: McpServer, task: TaskState): void;
+export declare function throwTaskNotFound(): never;
+export declare function handleToolCallRequest(server: McpServer, request: ExtendedCallToolRequest, context: ToolCallContext): Promise<ServerResult>;
+interface TaskHandlerRegistrationOptions {
+    requireInterception?: boolean;
+}
+interface TaskHandlerRegistrationResult {
+    interceptedToolsCall: boolean;
+    taskCapableToolsRegistered: boolean;
+}
+export declare function registerTaskHandlers(server: McpServer, options?: TaskHandlerRegistrationOptions): TaskHandlerRegistrationResult;
 export type TaskStatus = 'working' | 'input_required' | 'completed' | 'failed' | 'cancelled';
 export interface TaskError {
     code: number;
@@ -68,10 +111,89 @@ declare class TaskManager {
     waitForTerminalTask(taskId: string, ownerKey: string, signal?: AbortSignal): Promise<TaskState | undefined>;
     shrinkTtlAfterDelivery(taskId: string): void;
 }
-export declare const taskManager: TaskManager;
 export declare function encodeTaskCursor(anchorTaskId: string): string;
 export declare function decodeTaskCursor(cursor: string): {
     anchorTaskId: string;
 } | null;
+interface HandlerExtra {
+    sessionId?: string;
+    authInfo?: {
+        clientId?: string;
+        token?: string;
+    };
+    signal?: AbortSignal;
+    requestId?: string | number;
+    sendNotification?: (notification: ProgressNotification) => Promise<void>;
+    requestInfo?: unknown;
+}
+export interface ToolExecutionContext {
+    ownerKey: string;
+    sessionId?: string;
+    signal?: AbortSignal;
+    requestId?: string | number;
+    sendNotification?: (notification: ProgressNotification) => Promise<void>;
+    requestMeta?: ToolCallRequestMeta;
+}
+export type ToolCallContext = ToolExecutionContext;
+interface AuthIdentity {
+    clientId?: string;
+    token?: string;
+}
+/** Strip keys whose value is `undefined`, returning an object with only the
+ * present keys. Return type correctly omits the `undefined` union so the result
+ * is compatible with `exactOptionalPropertyTypes`. */
+type Compacted<T extends object> = {
+    [K in keyof T as Exclude<T[K], undefined> extends never ? never : K]?: Exclude<T[K], undefined>;
+};
+export declare function compact<T extends object>(obj: T): Compacted<T>;
+export declare function parseHandlerExtra(extra: unknown): HandlerExtra | undefined;
+export declare function buildAuthenticatedOwnerKey(authInfo?: AuthIdentity): string | undefined;
+export declare function resolveTaskOwnerKey(extra?: HandlerExtra): string;
+export declare function resolveToolCallContext(extra?: HandlerExtra, requestMeta?: ToolCallRequestMeta): ToolCallContext;
+export declare function buildToolHandlerExtra(context: ToolExecutionContext, requestMeta?: ToolCallRequestMeta): ToolHandlerExtra;
+export declare function withRequestContextIfMissing<TParams, TResult, TExtra = unknown>(handler: (params: TParams, extra?: TExtra) => Promise<TResult>): (params: TParams, extra?: TExtra) => Promise<TResult>;
+export declare function isServerResult(value: unknown): value is ServerResult;
+export type TaskCapableToolSupport = 'required' | 'optional' | 'forbidden';
+export interface TaskCapableToolDescriptor<TArgs = unknown> {
+    name: string;
+    parseArguments: (args: unknown) => TArgs;
+    execute: (args: TArgs, extra?: ToolHandlerExtra) => Promise<ServerResult>;
+    getCompletionStatusMessage?: (result: ServerResult) => string | undefined;
+    taskSupport?: TaskCapableToolSupport;
+    immediateResponse?: string;
+}
+export declare function registerTaskCapableTool<TArgs>(server: McpServer, descriptor: TaskCapableToolDescriptor<TArgs>): void;
+export declare function unregisterTaskCapableTool(server: McpServer, name: string): void;
+export declare function getTaskCapableTool(server: McpServer, name: string): TaskCapableToolDescriptor | undefined;
+export declare function getTaskCapableToolSupport(server: McpServer, name: string): TaskCapableToolSupport | undefined;
+export declare function hasTaskCapableTool(server: McpServer, name: string): boolean;
+export declare function hasRegisteredTaskCapableTools(server: McpServer): boolean;
+export declare function setTaskCapableToolSupport(server: McpServer, name: string, support: TaskCapableToolSupport): void;
+interface WaitableTask {
+    taskId: string;
+    ownerKey: string;
+    status: string;
+    ttl: number;
+    _createdAtMs: number;
+}
+type TaskWaiter<TTask extends WaitableTask> = (task: TTask) => void;
+export declare class TaskWaiterRegistry<TTask extends WaitableTask> {
+    private readonly isTerminalStatus;
+    private waiters;
+    constructor(isTerminalStatus: (status: TTask['status']) => boolean);
+    add(taskId: string, waiter: TaskWaiter<TTask>): void;
+    remove(taskId: string, waiter: TaskWaiter<TTask> | null): void;
+    notify(task: TTask): void;
+}
+export declare function waitForTerminalTask<TTask extends WaitableTask>(options: {
+    taskId: string;
+    ownerKey: string;
+    signal?: AbortSignal;
+    lookupTask: (taskId: string, ownerKey: string) => TTask | undefined;
+    removeTask: (taskId: string) => void;
+    registry: TaskWaiterRegistry<TTask>;
+    isTerminalStatus: (status: TTask['status']) => boolean;
+}): Promise<TTask | undefined>;
+export declare const taskManager: TaskManager;
 export {};
 //# sourceMappingURL=manager.d.ts.map

package/dist/tasks/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/tasks/manager.ts"],"names":[],"mappings":"AAgBA,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,gBAAgB,GAChB,WAAW,GACX,QAAQ,GACR,WAAW,CAAC;AAEhB,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAMD,UAAU,iBAAiB;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,IAAI,EAAE;QACJ,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,UAAU,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,GAAG,EAAE,MAAM,CAAC;QACZ,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAiFD,cAAM,WAAW;IACf,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAEtB;IACF,OAAO,CAAC,eAAe,CAA+C;IAEtE,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,kBAAkB;IAkB1B,OAAO,CAAC,UAAU;IAgBlB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,mBAAmB;IAoB3B,UAAU,CACR,OAAO,CAAC,EAAE,iBAAiB,EAC3B,aAAa,SAAiB,EAC9B,QAAQ,GAAE,MAA0B,GACnC,SAAS;IAiCZ,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAIjE,UAAU,CACR,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,GAAG,WAAW,CAAC,CAAC,GACxD,IAAI;IAmCP,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAuBpE,kBAAkB,CAChB,QAAQ,EAAE,MAAM,EAChB,aAAa,SAAkE,GAC9E,SAAS,EAAE;IAuBd,OAAO,CAAC,WAAW;IA2BnB,SAAS,CAAC,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG;QACzE,KAAK,EAAE,SAAS,EAAE,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;IAgBD,OAAO,CAAC,mBAAmB;IAQrB,mBAAmB,CACvB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAcjC,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAU7C;AAED,eAAO,MAAM,WAAW,aAAoB,CAAC;AAY7C,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAO7D;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,GACb;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA0BjC"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/tasks/manager.ts"],"names":[],"mappings":"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"}