@namzu/sdk 30.2.0 → 31.0.0

package/dist/public-types.d.ts

@@ -36,28 +36,30 @@ export type * from './types/bus/index.js';
 export type * from './types/probe/index.js';
 export type * from './types/doctor/index.js';
 export type * from './types/workspace/index.js';
+export type * from './types/goal/index.js';
 export type * from './types/session/index.js';
 export type { AgentDefaults, AgentInfo, ApiError, ApiErrorType, ApiPermissionMode, CreateMessageRequest, CreateRunRequest, CreateStatelessRunRequest, ISOTimestamp, PaginatedResponse, PaginationParams, RunConfig, RunHierarchyNode, RunStopReason, RunUsage, StreamEvent, StreamEventType, ToolCallInfo, WireRun, WireRunStatus, } from './contracts/api.js';
 export type { CompactionConfig, PluginRuntimeConfig, RuntimeConfig, } from './config/runtime.js';
-export type { AdvisoryCallContext, AdvisoryExecutionResult } from './advisory/index.js';
+export type { AdvisoryCallContext, AdvisoryExecutionResult, } from './advisory/index.js';
 export type { CacheRates, ModelPricing } from './utils/cost.js';
 export type { VendorRates } from './pricing/index.js';
 export type { PricingSubject } from './manager/run/persistence.js';
-export type { FrontmatterValue, ParsedFrontmatter } from './utils/frontmatter.js';
+export type { FrontmatterValue, ParsedFrontmatter, } from './utils/frontmatter.js';
 export type { Logger } from './utils/logger.js';
 export type { LevelFilter, LogRecord, LogSink, LogSinkCounters, Resource, Severity, } from './utils/log/index.js';
-export type { ShellCompressOptions, ShellCompressResult } from './utils/shell-compress.js';
+export type { ShellCompressOptions, ShellCompressResult, } from './utils/shell-compress.js';
 export type { QueryParams } from './runtime/query/index.js';
-export type { PromptCacheConfig, PromptCacheInput } from './runtime/query/prompt-cache.js';
-export type { LimitCheckResult, LimitCheckerState, RunReporter } from './run/index.js';
+export type { ProjectInstructionCallbackContext, ProjectInstructionContext, ProjectInstructionSnapshotUpdate, ToolResultObservation, } from './runtime/query/project-instructions.js';
+export type { PromptCacheConfig, PromptCacheInput, } from './runtime/query/prompt-cache.js';
+export type { LimitCheckResult, LimitCheckerState, RunReporter, } from './run/index.js';
 export type { AgentIdentity, DefineAgentOptions, Disposable, RunAgentOptions, RunAgentResult, } from './agents/index.js';
 export type { ActivityEvent, ActivityEventListener, DiskMemoryStoreConfig, DiskTaskStoreConfig, Identifiable, Timestamped, } from './store/index.js';
-export type { ManagedRegistryConfig, ToolExecutionResult } from './registry/index.js';
+export type { ManagedRegistryConfig, ToolExecutionResult, } from './registry/index.js';
 export type { PluginLifecycleManagerConfig } from './plugin/lifecycle.js';
-export type { PlanApprovalHandler, PlanEvent, PlanEventListener } from './manager/index.js';
+export type { PlanApprovalHandler, PlanEvent, PlanEventListener, } from './manager/index.js';
 export type { DefineToolOptions } from './tools/defineTool.js';
 export type { AdvisoryToolsOptions } from './tools/advisory/index.js';
-export type { CoordinatorToolsOptions, TaskLaunchedCallback } from './tools/coordinator/index.js';
+export type { CoordinatorToolsOptions, TaskLaunchedCallback, } from './tools/coordinator/index.js';
 export type { RegisterSharedRunPlanInput, SharedRunWorkspaceConfig, } from './session/workspace/index.js';
 export type { ConnectorManagerConfig, EnvironmentConnectorManagerConfig, EnvironmentConnectorSetup, HybridExecutionContextOptions, LocalExecutionContextOptions, MCPServerResourceProvider, MCPServerPromptProvider, MCPServerToolProvider, RemoteExecutionContextOptions, TenantConnectorManagerConfig, } from './connector/index.js';
 export type { ConnectorRouterInput, ConnectorToolConfig, ConnectorToolRouterConfig, ConnectorToolStrategy, } from './connector/tools/index.js';
@@ -66,7 +68,23 @@ export type { MappedStreamEvent } from './bridge/sse/index.js';
 export type { AgentBusConfig } from './bus/index.js';
 export type { ToolCallContext } from './authorization/index.js';
 export type { PermissionPreset } from './authorization/index.js';
-export type { DiskSessionStoreConfig, LinkageView } from './store/session/index.js';
+export type { DiskSessionStoreConfig, LinkageView, } from './store/session/index.js';
+export type { DiskTopicStateStoreConfig } from './store/topic/state.js';
+export type { EnvCredentialProviderOptions } from './vault/CredentialProvider.js';
+export type { DiskMessageFeedbackStoreConfig } from './store/feedback/disk.js';
+export type { MessageExistenceCheck } from './store/feedback/memory.js';
+export type { AgentManagerDeps } from './manager/agent/lifecycle.js';
+export type { ProjectManagerDeps } from './manager/project/lifecycle.js';
+export type { TopicManagerDeps } from './manager/topic/lifecycle.js';
+export type { FileLockManagerConfig } from './bus/lock.js';
+export type { GitWorktreeDriverConfig } from './session/workspace/git-worktree.js';
+export type { CapacityDimension } from './session/handoff/capacity.js';
+export type { HandoffLockRejectedReason } from './session/handoff/version.js';
+export type { SessionSummaryMaterializerDeps } from './session/summary/materialize.js';
+export type { ArchivalManagerDeps } from './session/retention/archive.js';
+export type { ArchiveBackendRef } from './types/retention/archive-backend-ref.js';
+export type { DiskArchiveBackendConfig } from './session/retention/disk-backend.js';
+export type { SlidingWindowManagerConfig } from './compaction/managers/slidingWindow.js';
 export type { ContextReducer, ContextReduction, ContextReductionReason, SlidingWindowOptions, ConversationManager, CompactionStrategy, DanglingResult, FileAction, FileSlot, PlanSlot, ToolResultSlot, WorkingState, } from './compaction/index.js';
 export type * from './eval/index.js';
 export type * from './types/guardrail/index.js';
@@ -75,13 +93,16 @@ export type { TopicState } from './types/topic/state.js';
 export type { ObjectiveAdvance, ObjectiveAdvanceResult, ObjectiveBlock, ObjectivePhase, ObjectiveRefusal, ObjectiveRoundVerdict, TopicObjective, } from './types/topic/objective.js';
 export type { CreateObjectiveParams, DiskTopicObjectiveStoreConfig, TopicObjectiveStore, } from './store/topic/objective.js';
 export type { AdvanceObjectiveParams, DriveObjectiveParams, } from './manager/topic/objective.js';
-export type { AgentHandle, AgentHandleOptions, AgentHandleStatus } from './agents/handle.js';
+export type { CreateSessionGoalParams, DiskSessionGoalStoreConfig, EditSessionGoalParams, InMemorySessionGoalStoreConfig, SessionGoalStore, } from './store/goal/index.js';
+export type { ResolveGoalRoundAuthority } from './tools/goal/index.js';
+export type { ActiveSessionGoal } from './manager/goal/activation.js';
+export type { AgentHandle, AgentHandleOptions, AgentHandleStatus, } from './agents/handle.js';
 export type { CredentialDescription, CredentialProvider, CredentialRef as CredentialName, ResolvedCredential, } from './vault/CredentialProvider.js';
 export type { ApprovalPolicy, ApprovalPolicyChange, ApprovalPolicyChangedEvent, RunApprovalPolicy, } from './types/hitl/policy.js';
 export type { PromptContribution, PromptContributionContext, PromptPlacement, } from './prompt/index.js';
 export type { GuardedFetchConfig, WebFetchProvider, WebFetchRefusalReason, WebFetchRequest, WebFetchResult, WebSearchHit, WebSearchProvider, WebSearchRequest, WebSearchResult, } from './connector/web/index.js';
-export type { AttachmentStore, StoredAttachment, StoredBytes, } from './store/attachment/index.js';
+export type { AttachmentOperationOptions, AttachmentStore, StoredAttachment, StoredBytes, } from './store/attachment/index.js';
 export type { ReadModel, RunStatusReadModelOptions, RunStatusState, } from './read-model/index.js';
-export type { RunQueryOptions, ShedPass } from './run-query/index.js';
+export type { RunQueryOptions, RunTranscriptUnavailableReason, ShedPass, } from './run-query/index.js';
 export type { OpenTerminalOptions, PtyLoader, PtyModule, PtyProcess, TerminalSession, TerminalSize, } from './sandbox/terminal.js';
 //# sourceMappingURL=public-types.d.ts.map

package/dist/public-types.d.ts.map

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

package/dist/rag/embedding.d.ts

@@ -1,4 +1,6 @@
-import type { EmbeddingProvider, HttpEmbeddingConfig } from '../types/rag/index.js';
+import type { EmbeddingProvider, HttpEmbeddingConfig, RAGOperationOptions } from '../types/rag/index.js';
+/** Each HTTP embedding batch owns a finite transport lifetime by default. */
+export declare const DEFAULT_EMBEDDING_REQUEST_TIMEOUT_MS = 30000;
 export declare class HttpEmbeddingProvider implements EmbeddingProvider {
     readonly id = "http-embedding";
     readonly model: string;
@@ -6,9 +8,12 @@ export declare class HttpEmbeddingProvider implements EmbeddingProvider {
     private readonly apiKey;
     private readonly baseUrl;
     private readonly batchSize;
+    private readonly requestTimeoutMs;
     constructor(config: HttpEmbeddingConfig);
-    embed(texts: string[]): Promise<number[][]>;
-    embedQuery(query: string): Promise<number[]>;
+    embed(texts: string[], options?: RAGOperationOptions): Promise<number[][]>;
+    embedQuery(query: string, options?: RAGOperationOptions): Promise<number[]>;
     private callEmbeddingApi;
+    private performEmbeddingRequest;
+    private validateEmbeddingResponse;
 }
 //# sourceMappingURL=embedding.d.ts.map

package/dist/rag/embedding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embedding.d.ts","sourceRoot":"","sources":["../../src/rag/embedding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAuBnF,qBAAa,qBAAsB,YAAW,iBAAiB;IAC9D,QAAQ,CAAC,EAAE,oBAAmB;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAE3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;gBAEtB,MAAM,EAAE,mBAAmB;IAQjC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAY3C,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YAQpC,gBAAgB;CAsB9B"}
+{"version":3,"file":"embedding.d.ts","sourceRoot":"","sources":["../../src/rag/embedding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,MAAM,uBAAuB,CAAA;AAE9B,6EAA6E;AAC7E,eAAO,MAAM,oCAAoC,QAAS,CAAA;AAuD1D,qBAAa,qBAAsB,YAAW,iBAAiB;IAC9D,QAAQ,CAAC,EAAE,oBAAmB;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAE3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;gBAE7B,MAAM,EAAE,mBAAmB;IASjC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAa9E,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YAQvE,gBAAgB;YAuDhB,uBAAuB;IAuBrC,OAAO,CAAC,yBAAyB;CAyCjC"}

package/dist/rag/embedding.js

@@ -1,3 +1,30 @@
+/** Each HTTP embedding batch owns a finite transport lifetime by default. */
+export const DEFAULT_EMBEDDING_REQUEST_TIMEOUT_MS = 30_000;
+const MAX_TIMER_DELAY_MS = 2_147_483_647;
+function resolveRequestTimeoutMs(value) {
+    const resolved = value ?? DEFAULT_EMBEDDING_REQUEST_TIMEOUT_MS;
+    if (!Number.isInteger(resolved) || resolved < 0 || resolved > MAX_TIMER_DELAY_MS) {
+        throw new RangeError(`requestTimeoutMs must be an integer from 0 to ${MAX_TIMER_DELAY_MS}; received ${String(resolved)}`);
+    }
+    return resolved;
+}
+function resolveBatchSize(value) {
+    const resolved = value ?? 64;
+    if (!Number.isSafeInteger(resolved) || resolved <= 0) {
+        throw new RangeError(`batchSize must be a positive safe integer; received ${String(resolved)}`);
+    }
+    return resolved;
+}
+function resolveDimensions(value) {
+    const resolved = value ?? 1536;
+    if (!Number.isSafeInteger(resolved) || resolved <= 0) {
+        throw new RangeError(`dimensions must be a positive safe integer; received ${String(resolved)}`);
+    }
+    return resolved;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
 /**
  * Embeddings over the common HTTP shape: `POST {baseUrl}/embeddings` with
  * a bearer key, `{ model, input, dimensions }` in, `{ data: [{ index,
@@ -25,30 +52,84 @@ export class HttpEmbeddingProvider {
     apiKey;
     baseUrl;
     batchSize;
+    requestTimeoutMs;
     constructor(config) {
         this.model = config.model;
-        this.dimensions = config.dimensions ?? 1536;
+        this.dimensions = resolveDimensions(config.dimensions);
         this.apiKey = config.apiKey;
         this.baseUrl = stripTrailingSlashes(config.baseUrl);
-        this.batchSize = config.batchSize ?? 64;
+        this.batchSize = resolveBatchSize(config.batchSize);
+        this.requestTimeoutMs = resolveRequestTimeoutMs(config.requestTimeoutMs);
     }
-    async embed(texts) {
+    async embed(texts, options = {}) {
+        options.signal?.throwIfAborted();
         const results = [];
         for (let i = 0; i < texts.length; i += this.batchSize) {
             const batch = texts.slice(i, i + this.batchSize);
-            const batchResults = await this.callEmbeddingApi(batch);
+            const batchResults = await this.callEmbeddingApi(batch, options.signal);
             results.push(...batchResults);
         }
         return results;
     }
-    async embedQuery(query) {
-        const [result] = await this.embed([query]);
+    async embedQuery(query, options = {}) {
+        const [result] = await this.embed([query], options);
         if (!result) {
             throw new Error('Embedding returned no results');
         }
         return result;
     }
-    async callEmbeddingApi(texts) {
+    async callEmbeddingApi(texts, callerSignal) {
+        callerSignal?.throwIfAborted();
+        // The provider owns this controller. A caller cancellation flows into it,
+        // while the provider's deadline never aborts the caller's controller.
+        const transport = new AbortController();
+        let rejectCallerAbort;
+        const callerAbort = callerSignal
+            ? new Promise((_resolve, reject) => {
+                rejectCallerAbort = reject;
+            })
+            : undefined;
+        const onCallerAbort = () => {
+            const reason = callerSignal?.reason;
+            // Settle the public operation with the caller's exact reason before
+            // aborting fetch: transports commonly turn every abort into a generic
+            // DOMException, which would erase who stopped the run.
+            rejectCallerAbort?.(reason);
+            if (!transport.signal.aborted)
+                transport.abort(reason);
+        };
+        callerSignal?.addEventListener('abort', onCallerAbort, { once: true });
+        let timer;
+        const timeout = this.requestTimeoutMs > 0
+            ? new Promise((_resolve, reject) => {
+                timer = setTimeout(() => {
+                    const error = new Error(`Embedding request timed out after ${this.requestTimeoutMs}ms`);
+                    error.name = 'TimeoutError';
+                    reject(error);
+                    if (!transport.signal.aborted)
+                        transport.abort(error);
+                }, this.requestTimeoutMs);
+            })
+            : undefined;
+        const request = this.performEmbeddingRequest(texts, transport.signal);
+        // A custom or polyfilled fetch may ignore AbortSignal and reject later.
+        // Once the operation has settled, that late rejection is not allowed to
+        // become an unhandled process error.
+        request.catch(() => { });
+        try {
+            return await Promise.race([
+                request,
+                ...(callerAbort ? [callerAbort] : []),
+                ...(timeout ? [timeout] : []),
+            ]);
+        }
+        finally {
+            if (timer !== undefined)
+                clearTimeout(timer);
+            callerSignal?.removeEventListener('abort', onCallerAbort);
+        }
+    }
+    async performEmbeddingRequest(texts, signal) {
         const response = await fetch(`${this.baseUrl}/embeddings`, {
             method: 'POST',
             headers: {
@@ -60,13 +141,43 @@ export class HttpEmbeddingProvider {
                 input: texts,
                 dimensions: this.dimensions,
             }),
+            signal,
         });
         if (!response.ok) {
             const errorText = await response.text();
             throw new Error(`Embedding API error (${response.status}): ${errorText}`);
         }
-        const data = (await response.json());
-        return data.data.sort((a, b) => a.index - b.index).map((d) => d.embedding);
+        return this.validateEmbeddingResponse(await response.json(), texts.length);
+    }
+    validateEmbeddingResponse(value, expectedCount) {
+        if (!isRecord(value) || !Array.isArray(value.data)) {
+            throw new Error('Embedding API response must contain a data array');
+        }
+        if (value.data.length !== expectedCount) {
+            throw new Error(`Embedding API returned ${value.data.length} vectors for ${expectedCount} inputs`);
+        }
+        const embeddings = new Array(expectedCount);
+        const seen = new Set();
+        for (const item of value.data) {
+            if (!isRecord(item) || !Number.isSafeInteger(item.index)) {
+                throw new Error('Embedding API response contains a non-integer index');
+            }
+            const index = item.index;
+            if (index < 0 || index >= expectedCount) {
+                throw new Error(`Embedding API response index ${index} is outside the input range`);
+            }
+            if (seen.has(index)) {
+                throw new Error(`Embedding API response contains duplicate index ${index}`);
+            }
+            if (!Array.isArray(item.embedding) ||
+                item.embedding.length !== this.dimensions ||
+                !item.embedding.every((coordinate) => typeof coordinate === 'number' && Number.isFinite(coordinate))) {
+                throw new Error(`Embedding API response index ${index} must contain ${this.dimensions} finite numbers`);
+            }
+            seen.add(index);
+            embeddings[index] = item.embedding;
+        }
+        return embeddings;
     }
 }
 //# sourceMappingURL=embedding.js.map

package/dist/rag/embedding.js.map

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

package/dist/rag/index.d.ts

@@ -1,6 +1,6 @@
 export type { TenantScope, DocumentMetadata, Document, Chunk, ChunkContent, ChunkingStrategy, ChunkingConfig, Chunker, EmbeddingProvider, EmbeddingConfig, VectorSearchResult, VectorStoreQuery, VectorStore, RetrievalMode, RetrievalConfig, RetrievalQuery, RetrievalResult, Retriever, IngestionResult, IngestionPipeline, KnowledgeBaseConfig, KnowledgeBase, RAGToolInput, RAGContextConfig, RAGContext, } from '../types/rag/index.js';
 export { TextChunker, DEFAULT_CHUNKING_CONFIG } from './chunking.js';
-export { HttpEmbeddingProvider } from './embedding.js';
+export { DEFAULT_EMBEDDING_REQUEST_TIMEOUT_MS, HttpEmbeddingProvider } from './embedding.js';
 export { InMemoryVectorStore, cosineSimilarity } from './vector-store.js';
 export { DefaultRetriever, DEFAULT_RETRIEVAL_CONFIG } from './retriever.js';
 export { DefaultIngestionPipeline } from './ingestion.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rag/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,KAAK,EACL,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,OAAO,EACP,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,eAAe,EACf,cAAc,EACd,eAAe,EACf,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,UAAU,GACV,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAEpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAEtD,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEzE,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AAE3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AAEzD,OAAO,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAA;AAEvF,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rag/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,KAAK,EACL,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,OAAO,EACP,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,eAAe,EACf,cAAc,EACd,eAAe,EACf,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,UAAU,GACV,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAEpE,OAAO,EAAE,oCAAoC,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAE5F,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEzE,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AAE3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AAEzD,OAAO,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAA;AAEvF,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA"}

package/dist/rag/index.js

@@ -1,5 +1,5 @@
 export { TextChunker, DEFAULT_CHUNKING_CONFIG } from './chunking.js';
-export { HttpEmbeddingProvider } from './embedding.js';
+export { DEFAULT_EMBEDDING_REQUEST_TIMEOUT_MS, HttpEmbeddingProvider } from './embedding.js';
 export { InMemoryVectorStore, cosineSimilarity } from './vector-store.js';
 export { DefaultRetriever, DEFAULT_RETRIEVAL_CONFIG } from './retriever.js';
 export { DefaultIngestionPipeline } from './ingestion.js';

package/dist/rag/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rag/index.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAEpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAEtD,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEzE,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AAE3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AAEzD,OAAO,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAA;AAEvF,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rag/index.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAEpE,OAAO,EAAE,oCAAoC,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAE5F,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAEzE,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AAE3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AAEzD,OAAO,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAA;AAEvF,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA"}

package/dist/rag/ingestion.d.ts

@@ -1,12 +1,12 @@
 import type { DocumentId, KnowledgeBaseId } from '../types/ids/index.js';
-import type { ChunkingConfig, DocumentMetadata, EmbeddingProvider, IngestionPipeline, IngestionResult, TenantScope, VectorStore } from '../types/rag/index.js';
+import type { ChunkingConfig, DocumentMetadata, EmbeddingProvider, IngestionPipeline, IngestionResult, RAGOperationOptions, TenantScope, VectorStore } from '../types/rag/index.js';
 export declare class DefaultIngestionPipeline implements IngestionPipeline {
     private readonly vectorStore;
     private readonly embeddingProvider;
     private readonly chunker;
     private readonly chunkingConfig;
     constructor(vectorStore: VectorStore, embeddingProvider: EmbeddingProvider, chunkingConfig?: Partial<ChunkingConfig>);
-    ingest(content: string, metadata: DocumentMetadata, scope: TenantScope, knowledgeBaseId: KnowledgeBaseId): Promise<IngestionResult>;
+    ingest(content: string, metadata: DocumentMetadata, scope: TenantScope, knowledgeBaseId: KnowledgeBaseId, options?: RAGOperationOptions): Promise<IngestionResult>;
     remove(documentId: DocumentId): Promise<void>;
 }
 //# sourceMappingURL=ingestion.d.ts.map

package/dist/rag/ingestion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ingestion.d.ts","sourceRoot":"","sources":["../../src/rag/ingestion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACxE,OAAO,KAAK,EAEX,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,WAAW,EACX,MAAM,uBAAuB,CAAA;AAI9B,qBAAa,wBAAyB,YAAW,iBAAiB;IAKhE,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IALnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;gBAG7B,WAAW,EAAE,WAAW,EACxB,iBAAiB,EAAE,iBAAiB,EACrD,cAAc,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAMnC,MAAM,CACX,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,EAAE,WAAW,EAClB,eAAe,EAAE,eAAe,GAC9B,OAAO,CAAC,eAAe,CAAC;IAsCrB,MAAM,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAGnD"}
+{"version":3,"file":"ingestion.d.ts","sourceRoot":"","sources":["../../src/rag/ingestion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACxE,OAAO,KAAK,EAEX,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,WAAW,EACX,WAAW,EACX,MAAM,uBAAuB,CAAA;AAK9B,qBAAa,wBAAyB,YAAW,iBAAiB;IAKhE,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IALnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;gBAG7B,WAAW,EAAE,WAAW,EACxB,iBAAiB,EAAE,iBAAiB,EACrD,cAAc,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC;IAMnC,MAAM,CACX,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,EAAE,WAAW,EAClB,eAAe,EAAE,eAAe,EAChC,OAAO,CAAC,EAAE,mBAAmB,GAC3B,OAAO,CAAC,eAAe,CAAC;IAiDrB,MAAM,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CAGnD"}

package/dist/rag/ingestion.js

@@ -1,5 +1,6 @@
 import { generateChunkId, generateDocumentId } from '../utils/id.js';
 import { DEFAULT_CHUNKING_CONFIG, TextChunker } from './chunking.js';
+import { awaitRAGOperation } from './operation.js';
 export class DefaultIngestionPipeline {
     vectorStore;
     embeddingProvider;
@@ -11,7 +12,8 @@ export class DefaultIngestionPipeline {
         this.chunker = new TextChunker();
         this.chunkingConfig = { ...DEFAULT_CHUNKING_CONFIG, ...chunkingConfig };
     }
-    async ingest(content, metadata, scope, knowledgeBaseId) {
+    async ingest(content, metadata, scope, knowledgeBaseId, options) {
+        options?.signal?.throwIfAborted();
         const startTime = Date.now();
         const documentId = generateDocumentId();
         const chunkContents = this.chunker.chunk(content, this.chunkingConfig);
@@ -19,7 +21,14 @@ export class DefaultIngestionPipeline {
             return { documentId, chunkCount: 0, totalTokens: 0, durationMs: Date.now() - startTime };
         }
         const texts = chunkContents.map((c) => c.content);
-        const embeddings = await this.embeddingProvider.embed(texts);
+        const embeddings = options
+            ? await this.embeddingProvider.embed(texts, options)
+            : await this.embeddingProvider.embed(texts);
+        // A custom provider may accept the signal yet settle successfully after
+        // cancellation. Its cooperation is outside the kernel's control; whether
+        // Namzu now persists those late results is not. Recheck before the first
+        // state-changing store call.
+        options?.signal?.throwIfAborted();
         const now = Date.now();
         const chunks = chunkContents.map((cc, i) => ({
             id: generateChunkId(),
@@ -34,7 +43,10 @@ export class DefaultIngestionPipeline {
             metadata: { ...metadata, chunkIndex: cc.index },
             createdAt: now,
         }));
-        await this.vectorStore.upsert(chunks);
+        const upsert = options
+            ? this.vectorStore.upsert(chunks, options)
+            : this.vectorStore.upsert(chunks);
+        await awaitRAGOperation(upsert, options?.signal);
         const totalTokens = chunks.reduce((sum, c) => sum + c.tokenCount, 0);
         return {
             documentId,

package/dist/rag/ingestion.js.map

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

package/dist/rag/knowledge-base.d.ts

@@ -1,5 +1,5 @@
 import type { DocumentId, KnowledgeBaseId } from '../types/ids/index.js';
-import type { DocumentMetadata, EmbeddingProvider, IngestionResult, KnowledgeBase, KnowledgeBaseConfig, RetrievalQuery, RetrievalResult, VectorStore } from '../types/rag/index.js';
+import type { DocumentMetadata, EmbeddingProvider, IngestionResult, KnowledgeBase, KnowledgeBaseConfig, RAGOperationOptions, RetrievalQuery, RetrievalResult, VectorStore } from '../types/rag/index.js';
 export declare class DefaultKnowledgeBase implements KnowledgeBase {
     readonly id: KnowledgeBaseId;
     readonly config: KnowledgeBaseConfig;
@@ -8,9 +8,9 @@ export declare class DefaultKnowledgeBase implements KnowledgeBase {
     private readonly scope;
     private readonly vectorStore;
     constructor(config: KnowledgeBaseConfig, vectorStore: VectorStore, embeddingProvider: EmbeddingProvider);
-    ingest(content: string, metadata?: DocumentMetadata): Promise<IngestionResult>;
+    ingest(content: string, metadata?: DocumentMetadata, options?: RAGOperationOptions): Promise<IngestionResult>;
     remove(documentId: DocumentId): Promise<void>;
-    query(query: RetrievalQuery): Promise<RetrievalResult>;
+    query(query: RetrievalQuery, options?: RAGOperationOptions): Promise<RetrievalResult>;
     clear(): Promise<void>;
 }
 //# sourceMappingURL=knowledge-base.d.ts.map

package/dist/rag/knowledge-base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"knowledge-base.d.ts","sourceRoot":"","sources":["../../src/rag/knowledge-base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACxE,OAAO,KAAK,EAEX,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,mBAAmB,EAEnB,cAAc,EACd,eAAe,EAEf,WAAW,EACX,MAAM,uBAAuB,CAAA;AAM9B,qBAAa,oBAAqB,YAAW,aAAa;IACzD,QAAQ,CAAC,EAAE,EAAE,eAAe,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAA;IAEpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;gBAGxC,MAAM,EAAE,mBAAmB,EAC3B,WAAW,EAAE,WAAW,EACxB,iBAAiB,EAAE,iBAAiB;IAyB/B,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAIlF,MAAM,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAItD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}
+{"version":3,"file":"knowledge-base.d.ts","sourceRoot":"","sources":["../../src/rag/knowledge-base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACxE,OAAO,KAAK,EAEX,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EAEnB,cAAc,EACd,eAAe,EAEf,WAAW,EACX,MAAM,uBAAuB,CAAA;AAM9B,qBAAa,oBAAqB,YAAW,aAAa;IACzD,QAAQ,CAAC,EAAE,EAAE,eAAe,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAA;IAEpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;gBAGxC,MAAM,EAAE,mBAAmB,EAC3B,WAAW,EAAE,WAAW,EACxB,iBAAiB,EAAE,iBAAiB;IAyB/B,MAAM,CACX,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,gBAAqB,EAC/B,OAAO,CAAC,EAAE,mBAAmB,GAC3B,OAAO,CAAC,eAAe,CAAC;IAMrB,MAAM,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,KAAK,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAMrF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}

package/dist/rag/knowledge-base.js

@@ -28,14 +28,18 @@ export class DefaultKnowledgeBase {
         this.ingestion = new DefaultIngestionPipeline(vectorStore, embeddingProvider, chunkingConfig);
         this.retriever = new DefaultRetriever(vectorStore, embeddingProvider, retrievalConfig);
     }
-    async ingest(content, metadata = {}) {
-        return this.ingestion.ingest(content, metadata, this.scope, this.id);
+    async ingest(content, metadata = {}, options) {
+        return options
+            ? this.ingestion.ingest(content, metadata, this.scope, this.id, options)
+            : this.ingestion.ingest(content, metadata, this.scope, this.id);
     }
     async remove(documentId) {
         return this.ingestion.remove(documentId);
     }
-    async query(query) {
-        return this.retriever.retrieve(query, this.scope, this.id);
+    async query(query, options) {
+        return options
+            ? this.retriever.retrieve(query, this.scope, this.id, options)
+            : this.retriever.retrieve(query, this.scope, this.id);
     }
     async clear() {
         await this.vectorStore.deleteByKnowledgeBase(this.id, this.scope.tenantId);

package/dist/rag/knowledge-base.js.map

@@ -1 +1 @@
-{"version":3,"file":"knowledge-base.js","sourceRoot":"","sources":["../../src/rag/knowledge-base.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AACzD,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAE3E,MAAM,OAAO,oBAAoB;IACvB,EAAE,CAAiB;IACnB,MAAM,CAAqB;IAEnB,SAAS,CAA0B;IACnC,SAAS,CAAkB;IAC3B,KAAK,CAAa;IAClB,WAAW,CAAa;IAEzC,YACC,MAA2B,EAC3B,WAAwB,EACxB,iBAAoC;QAEpC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAA;QAC9B,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,IAAI,uBAAuB,EAAE,CAAA;QAChD,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAA;QAExC,IAAI,CAAC,KAAK,GAAG;YACZ,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,SAAS,EAAE,MAAM,CAAC,SAAS;SAC3B,CAAA;QAED,MAAM,cAAc,GAAmB;YACtC,GAAG,uBAAuB;YAC1B,GAAG,MAAM,CAAC,QAAQ;SAClB,CAAA;QAED,MAAM,eAAe,GAAoB;YACxC,GAAG,wBAAwB;YAC3B,GAAG,MAAM,CAAC,SAAS;SACnB,CAAA;QAED,IAAI,CAAC,SAAS,GAAG,IAAI,wBAAwB,CAAC,WAAW,EAAE,iBAAiB,EAAE,cAAc,CAAC,CAAA;QAC7F,IAAI,CAAC,SAAS,GAAG,IAAI,gBAAgB,CAAC,WAAW,EAAE,iBAAiB,EAAE,eAAe,CAAC,CAAA;IACvF,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,WAA6B,EAAE;QAC5D,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAA;IACrE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,UAAsB;QAClC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;IACzC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAqB;QAChC,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAA;IAC3D,CAAC;IAED,KAAK,CAAC,KAAK;QACV,MAAM,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IAC3E,CAAC;CACD"}
+{"version":3,"file":"knowledge-base.js","sourceRoot":"","sources":["../../src/rag/knowledge-base.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AACzD,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAE3E,MAAM,OAAO,oBAAoB;IACvB,EAAE,CAAiB;IACnB,MAAM,CAAqB;IAEnB,SAAS,CAA0B;IACnC,SAAS,CAAkB;IAC3B,KAAK,CAAa;IAClB,WAAW,CAAa;IAEzC,YACC,MAA2B,EAC3B,WAAwB,EACxB,iBAAoC;QAEpC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAA;QAC9B,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,IAAI,uBAAuB,EAAE,CAAA;QAChD,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAA;QAExC,IAAI,CAAC,KAAK,GAAG;YACZ,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,SAAS,EAAE,MAAM,CAAC,SAAS;SAC3B,CAAA;QAED,MAAM,cAAc,GAAmB;YACtC,GAAG,uBAAuB;YAC1B,GAAG,MAAM,CAAC,QAAQ;SAClB,CAAA;QAED,MAAM,eAAe,GAAoB;YACxC,GAAG,wBAAwB;YAC3B,GAAG,MAAM,CAAC,SAAS;SACnB,CAAA;QAED,IAAI,CAAC,SAAS,GAAG,IAAI,wBAAwB,CAAC,WAAW,EAAE,iBAAiB,EAAE,cAAc,CAAC,CAAA;QAC7F,IAAI,CAAC,SAAS,GAAG,IAAI,gBAAgB,CAAC,WAAW,EAAE,iBAAiB,EAAE,eAAe,CAAC,CAAA;IACvF,CAAC;IAED,KAAK,CAAC,MAAM,CACX,OAAe,EACf,WAA6B,EAAE,EAC/B,OAA6B;QAE7B,OAAO,OAAO;YACb,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;YACxE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAA;IACjE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,UAAsB;QAClC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;IACzC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAqB,EAAE,OAA6B;QAC/D,OAAO,OAAO;YACb,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO,CAAC;YAC9D,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAA;IACvD,CAAC;IAED,KAAK,CAAC,KAAK;QACV,MAAM,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IAC3E,CAAC;CACD"}

package/dist/rag/operation.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Bound a host-supplied RAG promise to operation cancellation.
+ *
+ * The signal is also passed to cooperative providers. This race is the
+ * kernel-owned half of the contract: a custom store that ignores its signal
+ * may continue its own work, but it cannot keep the public operation pending
+ * or make a late result advance the caller's pipeline.
+ */
+export declare function awaitRAGOperation<T>(operation: Promise<T>, signal?: AbortSignal): Promise<T>;
+//# sourceMappingURL=operation.d.ts.map

package/dist/rag/operation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation.d.ts","sourceRoot":"","sources":["../../src/rag/operation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACxC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,EACrB,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,CAAC,CAAC,CAgBZ"}

package/dist/rag/operation.js

@@ -0,0 +1,26 @@
+/**
+ * Bound a host-supplied RAG promise to operation cancellation.
+ *
+ * The signal is also passed to cooperative providers. This race is the
+ * kernel-owned half of the contract: a custom store that ignores its signal
+ * may continue its own work, but it cannot keep the public operation pending
+ * or make a late result advance the caller's pipeline.
+ */
+export async function awaitRAGOperation(operation, signal) {
+    if (!signal)
+        return operation;
+    signal.throwIfAborted();
+    let rejectAbort;
+    const aborted = new Promise((_resolve, reject) => {
+        rejectAbort = reject;
+    });
+    const onAbort = () => rejectAbort?.(signal.reason);
+    signal.addEventListener('abort', onAbort, { once: true });
+    try {
+        return await Promise.race([operation, aborted]);
+    }
+    finally {
+        signal.removeEventListener('abort', onAbort);
+    }
+}
+//# sourceMappingURL=operation.js.map

package/dist/rag/operation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation.js","sourceRoot":"","sources":["../../src/rag/operation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACtC,SAAqB,EACrB,MAAoB;IAEpB,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAA;IAC7B,MAAM,CAAC,cAAc,EAAE,CAAA;IAEvB,IAAI,WAAqD,CAAA;IACzD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;QACvD,WAAW,GAAG,MAAM,CAAA;IACrB,CAAC,CAAC,CAAA;IACF,MAAM,OAAO,GAAG,GAAS,EAAE,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACxD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IAEzD,IAAI,CAAC;QACJ,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAA;IAChD,CAAC;YAAS,CAAC;QACV,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IAC7C,CAAC;AACF,CAAC"}

package/dist/rag/rag-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rag-tool.d.ts","sourceRoot":"","sources":["../../src/rag/rag-tool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAU1D,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa;;;;GAsDlD"}
+{"version":3,"file":"rag-tool.d.ts","sourceRoot":"","sources":["../../src/rag/rag-tool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAU1D,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa;;;;GAyDlD"}

package/dist/rag/rag-tool.js

@@ -17,7 +17,7 @@ export function createRAGTool(config) {
         readOnly: true,
         destructive: false,
         concurrencySafe: true,
-        async execute(input) {
+        async execute(input, toolContext) {
             const kbId = (input.knowledge_base_id === undefined
                 ? undefined
                 : asKnowledgeBaseId(input.knowledge_base_id)) ?? config.defaultKnowledgeBaseId;
@@ -31,10 +31,13 @@ export function createRAGTool(config) {
                     error: `Knowledge base not found: ${kbId ?? 'none configured'}`,
                 };
             }
-            const result = await kb.query({
+            const query = {
                 text: input.query,
                 config: { topK: input.top_k ?? config.topK ?? 5 },
-            });
+            };
+            const result = toolContext.abortSignal
+                ? await kb.query(query, { signal: toolContext.abortSignal })
+                : await kb.query(query);
             if (result.chunks.length === 0) {
                 return {
                     success: true,

package/dist/rag/rag-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"rag-tool.js","sourceRoot":"","sources":["../../src/rag/rag-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAEnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAE3D,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IAChF,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IAC9F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;CAC3F,CAAC,CAAA;AAEF,MAAM,UAAU,aAAa,CAAC,MAAqB;IAClD,OAAO,UAAU,CAAC;QACjB,IAAI,EAAE,kBAAkB;QACxB,WAAW,EACV,6KAA6K;QAC9K,WAAW,EAAE,cAAc;QAC3B,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE,CAAC,gBAAgB,CAAC;QAC/B,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,KAAK;QAClB,eAAe,EAAE,IAAI;QAErB,KAAK,CAAC,OAAO,CAAC,KAAK;YAClB,MAAM,IAAI,GACT,CAAC,KAAK,CAAC,iBAAiB,KAAK,SAAS;gBACrC,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,IAAI,MAAM,CAAC,sBAAsB,CAAA;YAChF,MAAM,EAAE,GAAG,IAAI;gBACd,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC;gBACjC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAA;YAE9C,IAAI,CAAC,EAAE,EAAE,CAAC;gBACT,OAAO;oBACN,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,EAAE;oBACV,KAAK,EAAE,6BAA6B,IAAI,IAAI,iBAAiB,EAAE;iBAC/D,CAAA;YACF,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC;gBAC7B,IAAI,EAAE,KAAK,CAAC,KAAK;gBACjB,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,IAAI,CAAC,EAAE;aACjD,CAAC,CAAA;YAEF,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAChC,OAAO;oBACN,OAAO,EAAE,IAAI;oBACb,MAAM,EAAE,qEAAqE;iBAC7E,CAAA;YACF,CAAC;YAED,MAAM,OAAO,GAAG,kBAAkB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,aAAa,CAAC,CAAA;YAEvE,OAAO;gBACN,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,OAAO,CAAC,OAAO;gBACvB,IAAI,EAAE;oBACL,OAAO,EAAE,OAAO,CAAC,OAAO;oBACxB,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,UAAU,EAAE,MAAM,CAAC,UAAU;iBAC7B;aACD,CAAA;QACF,CAAC;KACD,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"rag-tool.js","sourceRoot":"","sources":["../../src/rag/rag-tool.ts"],"names":[],"mappings":"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"}