@farukada/langchain-ts-rms 0.1.0

package/dist/lib/index.js

@@ -0,0 +1,61 @@
+// ── Public API entrypoint for @farukada/langchain-ts-rms ──
+// Tool composite factories
+export { createRmsLifecycleTools, createRmsToolFromEnv, createRmsLifecycleToolsFromEnv, createAllRmsToolsFromEnv, } from "./rmsTool.js";
+// Individual tool factories
+export { createResearchTool, buildWorkflowDeps, conductResearchDirect, streamResearch, } from "./tools/research.js";
+export { createGetResearchTool } from "./tools/getResearch.js";
+export { createListResearchTool } from "./tools/listResearch.js";
+export { createSearchResearchTool } from "./tools/searchResearch.js";
+export { createDeleteResearchTool } from "./tools/deleteResearch.js";
+export { createGetDatetimeTool } from "./tools/getDatetime.js";
+export { createRefreshResearchTool } from "./tools/refreshResearch.js";
+// Helpers
+export { stripNulls, normalizeInput, paginate, wrapToolResponse, getResearchOrThrow, matchesFilters, sanitizeNumericValues, } from "./helpers.js";
+// Schemas
+export { RmsResearchInputSchema, laxBool, laxInt, laxFloat } from "./schemas/researchSchemas.js";
+export { GetResearchInputSchema, ListResearchInputSchema, SearchResearchInputSchema, DeleteResearchInputSchema, GetDateTimeInputSchema, RefreshResearchInputSchema, coerceLifecycleInput, } from "./schemas/lifecycleSchemas.js";
+export { RMS_NODE_NAMES } from "../app/graph/workflow.js";
+export { summarizeTokenUsage } from "./helpers.js";
+// Domain contracts
+export { ResearchSchema, ResearchStatusSchema, SourceSummarySchema, RESPONSE_CONTRACT_VERSION, } from "../domain/contracts.js";
+export { isResearchFresh, calculateExpiresAt, buildResearch, buildCompositeSummary, mergeResearchMetadata, getResearchAge, getResearchAgeDays, } from "../domain/researchUtils.js";
+// Core logic
+export { evaluateFreshness } from "../app/freshness/evaluator.js";
+export { summarizeSearchResults, normalizeTags } from "../app/summarization/summarizer.js";
+export { SourceSummaryOutputSchema, BatchSummaryOutputSchema, } from "../app/summarization/summarizationSchema.js";
+export { synthesizeSummary } from "../app/summarization/synthesizer.js";
+export { SynthesisOutputSchema } from "../app/summarization/synthesisSchema.js";
+// Query rewriting (agentic RAG)
+export { evaluateQueryRelevance, MAX_REWRITES, MIN_RELEVANCE_SCORE, } from "../app/queryRewriting/rewriter.js";
+// Re-ranking
+export { rerankSearchResults } from "../app/reranking/reranker.js";
+// Query planning
+export { planSearchQueries } from "../app/queryPlanning/planner.js";
+export { QueryPlanOutputSchema } from "../app/queryPlanning/planner.js";
+// LangGraph workflow
+export { createRmsWorkflow } from "../app/graph/workflow.js";
+export { RmsStateAnnotation } from "../app/state/schema.js";
+// Governance
+export { checkGuardrail, requiresHumanApproval, evaluateGuardrails, DEFAULT_FORBIDDEN_PATTERNS, DEFAULT_MAX_SEARCH_COUNT, DEFAULT_MIN_CONFIDENCE, } from "../app/governance/guardrails.js";
+// Infrastructure factories
+export { createEmbeddingProvider } from "../infra/embeddings/embeddingProvider.js";
+export { createChatModelProvider } from "../infra/chat/chatModelProvider.js";
+export { performSearch } from "../infra/search/searxngClient.js";
+export { isBlockedUrl, filterBlockedUrls, DEFAULT_BLOCKED_DOMAINS, } from "../infra/search/urlBlocklist.js";
+export { extractContent, extractTextFromHtml, batchExtractContent, } from "../infra/content/contentExtractor.js";
+export { createQdrantClient, bootstrapQdrantCollections, RESEARCH_COLLECTION, } from "../infra/vector/qdrantClient.js";
+export { ResearchRepository } from "../infra/vector/researchRepository.js";
+// Observability
+export { log, logInfo, logWarn, logError, logDebug, setLogWriter, setLogSilent, setLogLevel, withNodeTiming, ErrorCodes, } from "../infra/observability/tracing.js";
+// Config
+export { loadEnv, resetEnv } from "../config/env.js";
+// Checkpointer
+export { createCheckpointer } from "../infra/checkpoint/checkpointerFactory.js";
+// Health Check
+export { checkHealth } from "../infra/healthCheck.js";
+// Rate Limiting
+export { TokenBucketLimiter, searchLimiter, contentLimiter, createSearchLimiter, createContentLimiter, } from "../infra/rateLimit/rateLimiter.js";
+export { CircuitBreaker, searchBreaker, contentBreaker, } from "../infra/rateLimit/circuitBreaker.js";
+// Token Usage
+export { TokenUsageCollector } from "../infra/observability/tokenCounter.js";
+//# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

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

package/dist/lib/rmsTool.d.ts

@@ -0,0 +1,28 @@
+import type { StructuredToolInterface } from "@langchain/core/tools";
+import type { RmsToolDeps, CreateRmsToolFromEnvOptions, AllRmsTools } from "./types.js";
+import { createResearchTool } from "./tools/research.js";
+import { createGetResearchTool } from "./tools/getResearch.js";
+import { createListResearchTool } from "./tools/listResearch.js";
+import { createSearchResearchTool } from "./tools/searchResearch.js";
+import { createDeleteResearchTool } from "./tools/deleteResearch.js";
+import { createGetDatetimeTool } from "./tools/getDatetime.js";
+import { createRefreshResearchTool } from "./tools/refreshResearch.js";
+export { createResearchTool, createGetResearchTool, createListResearchTool, createSearchResearchTool, createDeleteResearchTool, createGetDatetimeTool, createRefreshResearchTool, };
+/**
+ * Creates all RMS lifecycle tools (get, list, search, delete, refresh, datetime).
+ * Does NOT include the main research tool.
+ */
+export declare function createRmsLifecycleTools(deps: RmsToolDeps): StructuredToolInterface[];
+/**
+ * Creates the main `rms_research` tool from environment variables.
+ */
+export declare function createRmsToolFromEnv(options?: CreateRmsToolFromEnvOptions): Promise<StructuredToolInterface>;
+/**
+ * Creates all lifecycle tools from environment variables.
+ */
+export declare function createRmsLifecycleToolsFromEnv(options?: CreateRmsToolFromEnvOptions): Promise<StructuredToolInterface[]>;
+/**
+ * Creates ALL RMS tools (research + lifecycle) from environment variables.
+ */
+export declare function createAllRmsToolsFromEnv(options?: CreateRmsToolFromEnvOptions): Promise<AllRmsTools>;
+//# sourceMappingURL=rmsTool.d.ts.map

package/dist/lib/rmsTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rmsTool.d.ts","sourceRoot":"","sources":["../../src/lib/rmsTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,2BAA2B,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACxF,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAWvE,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,GAC1B,CAAC;AAIF;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,WAAW,GAAG,uBAAuB,EAAE,CASpF;AA2BD;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,uBAAuB,CAAC,CAGlC;AAED;;GAEG;AACH,wBAAsB,8BAA8B,CAClD,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAGpC;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,WAAW,CAAC,CAMtB"}

package/dist/lib/rmsTool.js

@@ -0,0 +1,79 @@
+import { createResearchTool } from "./tools/research.js";
+import { createGetResearchTool } from "./tools/getResearch.js";
+import { createListResearchTool } from "./tools/listResearch.js";
+import { createSearchResearchTool } from "./tools/searchResearch.js";
+import { createDeleteResearchTool } from "./tools/deleteResearch.js";
+import { createGetDatetimeTool } from "./tools/getDatetime.js";
+import { createRefreshResearchTool } from "./tools/refreshResearch.js";
+import { createEmbeddingProvider } from "../infra/embeddings/embeddingProvider.js";
+import { createChatModelProvider } from "../infra/chat/chatModelProvider.js";
+import { ResearchRepository } from "../infra/vector/researchRepository.js";
+import { createQdrantClient } from "../infra/vector/qdrantClient.js";
+import { createCheckpointer } from "../infra/checkpoint/checkpointerFactory.js";
+import { loadEnv } from "../config/env.js";
+// ── Re-exports for convenience ──
+export { createResearchTool, createGetResearchTool, createListResearchTool, createSearchResearchTool, createDeleteResearchTool, createGetDatetimeTool, createRefreshResearchTool, };
+// ── Composite factories ──
+/**
+ * Creates all RMS lifecycle tools (get, list, search, delete, refresh, datetime).
+ * Does NOT include the main research tool.
+ */
+export function createRmsLifecycleTools(deps) {
+    return [
+        createGetResearchTool(deps),
+        createListResearchTool(deps),
+        createSearchResearchTool(deps),
+        createDeleteResearchTool(deps),
+        createRefreshResearchTool(deps),
+        createGetDatetimeTool(),
+    ];
+}
+/**
+ * Internal: builds RmsToolDeps from environment variables.
+ * Creates a single shared Qdrant client and passes it to the repository.
+ */
+async function buildEnvDeps(options) {
+    const env = loadEnv();
+    const embeddings = createEmbeddingProvider();
+    const chatModel = createChatModelProvider();
+    const client = createQdrantClient();
+    const checkpointer = await createCheckpointer();
+    const researchRepository = new ResearchRepository({ embeddings, client });
+    const deps = {
+        researchRepository,
+        embeddings,
+        chatModel,
+        checkpointer,
+        freshnessDays: options?.freshnessDays ?? env.RMS_FRESHNESS_DAYS,
+    };
+    if (options?.toolName)
+        deps.toolName = options.toolName;
+    if (options?.toolDescription)
+        deps.toolDescription = options.toolDescription;
+    return deps;
+}
+/**
+ * Creates the main `rms_research` tool from environment variables.
+ */
+export async function createRmsToolFromEnv(options) {
+    const deps = await buildEnvDeps(options);
+    return createResearchTool(deps);
+}
+/**
+ * Creates all lifecycle tools from environment variables.
+ */
+export async function createRmsLifecycleToolsFromEnv(options) {
+    const deps = await buildEnvDeps(options);
+    return createRmsLifecycleTools(deps);
+}
+/**
+ * Creates ALL RMS tools (research + lifecycle) from environment variables.
+ */
+export async function createAllRmsToolsFromEnv(options) {
+    const deps = await buildEnvDeps(options);
+    return {
+        researchTool: createResearchTool(deps),
+        lifecycleTools: createRmsLifecycleTools(deps),
+    };
+}
+//# sourceMappingURL=rmsTool.js.map

package/dist/lib/rmsTool.js.map

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

package/dist/lib/schemas/lifecycleSchemas.d.ts

@@ -0,0 +1,42 @@
+import { z } from "zod/v4";
+/**
+ * Coerce LLM-sent string booleans / string numbers in raw tool input.
+ * Returns a shallow copy with coerced values; the original is not mutated.
+ *
+ * Apply to tool inputs containing laxBool / laxInt fields. Tools whose
+ * schemas only declare uuid / string inputs can skip this.
+ */
+export declare function coerceLifecycleInput<T extends Record<string, unknown>>(raw: T): T;
+export declare const GetResearchInputSchema: z.ZodObject<{
+    researchId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    research_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export declare const ListResearchInputSchema: z.ZodObject<{
+    status: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodString]>>>;
+    tenantId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    tenant_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    limit: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
+    offset: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
+}, z.core.$strip>;
+export declare const SearchResearchInputSchema: z.ZodObject<{
+    query: z.ZodString;
+    tenantId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    tenant_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    tags: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodString]>>>;
+    limit: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
+}, z.core.$strip>;
+export declare const DeleteResearchInputSchema: z.ZodObject<{
+    researchId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    research_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export declare const GetDateTimeInputSchema: z.ZodObject<{}, z.core.$strip>;
+export declare const RefreshResearchInputSchema: z.ZodObject<{
+    researchId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    research_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    maxResults: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
+    max_results: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
+}, z.core.$strip>;
+//# sourceMappingURL=lifecycleSchemas.d.ts.map

package/dist/lib/schemas/lifecycleSchemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycleSchemas.d.ts","sourceRoot":"","sources":["../../../src/lib/schemas/lifecycleSchemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAmB3B;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CA+CjF;AAID,eAAO,MAAM,sBAAsB;;;;iBAkB/B,CAAC;AAEL,eAAO,MAAM,uBAAuB;;;;;;iBAyBlC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;;;iBAgBpC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;iBAkBlC,CAAC;AAEL,eAAO,MAAM,sBAAsB,gCAE4C,CAAC;AAEhF,eAAO,MAAM,0BAA0B;;;;;;iBAuBnC,CAAC"}

package/dist/lib/schemas/lifecycleSchemas.js

@@ -0,0 +1,176 @@
+import { z } from "zod/v4";
+import { laxInt } from "./researchSchemas.js";
+/* -------------------------------------------------------------------------- */
+/*  Runtime coercion helper                                                   */
+/*                                                                            */
+/*  LLMs sometimes send booleans as strings ("true"/"false", "1"/"0",         */
+/*  "yes"/"no") and numbers as strings ("100") or even "null".                */
+/*  This helper normalizes the raw input BEFORE Zod schema parsing so that    */
+/*  the JSON Schema–safe schemas can still accept messy LLM output.           */
+/* -------------------------------------------------------------------------- */
+const BOOL_TRUE = new Set(["true", "1", "yes", "on"]);
+const BOOL_FALSE = new Set(["false", "0", "no", "off"]);
+const BOOL_FIELDS = new Set(["forceRefresh", "force_refresh"]);
+const INT_FIELDS = new Set(["maxResults", "max_results", "limit", "offset"]);
+const ARRAY_FIELDS = new Set(["status", "tags"]);
+/**
+ * Coerce LLM-sent string booleans / string numbers in raw tool input.
+ * Returns a shallow copy with coerced values; the original is not mutated.
+ *
+ * Apply to tool inputs containing laxBool / laxInt fields. Tools whose
+ * schemas only declare uuid / string inputs can skip this.
+ */
+export function coerceLifecycleInput(raw) {
+    const out = { ...raw };
+    for (const key of Object.keys(out)) {
+        const val = out[key];
+        // Treat the string "null" the same as actual null
+        if (val === "null") {
+            out[key] = null;
+            continue;
+        }
+        // Coerce string values for array fields
+        if (ARRAY_FIELDS.has(key) && typeof val === "string") {
+            const trimmed = val.trim();
+            if (trimmed === "" || trimmed === "undefined") {
+                out[key] = undefined;
+            }
+            else {
+                out[key] = [trimmed];
+            }
+            continue;
+        }
+        // Clean array fields that contain "null" strings or empty strings
+        if (ARRAY_FIELDS.has(key) && Array.isArray(val)) {
+            const cleaned = val.filter((v) => v !== null && v !== "null" && v !== "");
+            out[key] = cleaned.length > 0 ? cleaned : undefined;
+            continue;
+        }
+        // Coerce string booleans
+        if (BOOL_FIELDS.has(key) && typeof val === "string") {
+            const s = val.toLowerCase().trim();
+            if (BOOL_TRUE.has(s))
+                out[key] = true;
+            else if (BOOL_FALSE.has(s))
+                out[key] = false;
+            continue;
+        }
+        // Coerce string integers
+        if (INT_FIELDS.has(key) && typeof val === "string") {
+            const n = Number(val);
+            out[key] = Number.isFinite(n) ? Math.trunc(n) : undefined;
+            continue;
+        }
+    }
+    return out;
+}
+// ── Lifecycle schemas ──
+export const GetResearchInputSchema = z
+    .object({
+    researchId: z
+        .string()
+        .min(1)
+        .nullable()
+        .optional()
+        .meta({ description: "The UUID of the research entry to retrieve" }),
+    research_id: z
+        .string()
+        .min(1)
+        .nullable()
+        .optional()
+        .meta({ description: "Alias for researchId" }),
+    id: z.string().min(1).nullable().optional().meta({ description: "Alias for researchId" }),
+})
+    .refine((data) => !!(data.researchId ?? data.research_id ?? data.id), {
+    message: "One of researchId, research_id, or id must be provided",
+});
+export const ListResearchInputSchema = z.object({
+    status: z
+        .union([z.array(z.string()), z.string()])
+        .nullable()
+        .optional()
+        .meta({
+        description: "Filter by status(es): active, stale, refreshing, archived, low_confidence",
+        examples: ["active", ["active", "stale"]],
+    }),
+    tenantId: z.string().nullable().optional().meta({ description: "Filter by tenant ID" }),
+    tenant_id: z.string().nullable().optional().meta({ description: "Alias for tenantId" }),
+    limit: laxInt
+        .nullable()
+        .optional()
+        .meta({
+        description: "Maximum number of results to return. Defaults to 20.",
+        examples: [10, 20, 50],
+    }),
+    offset: laxInt
+        .nullable()
+        .optional()
+        .meta({
+        description: "Offset for pagination. Defaults to 0.",
+        examples: [0, 20, 40],
+    }),
+});
+export const SearchResearchInputSchema = z.object({
+    query: z
+        .string()
+        .min(1)
+        .meta({ description: "Semantic search query to find relevant research entries" }),
+    tenantId: z.string().nullable().optional().meta({ description: "Filter by tenant ID" }),
+    tenant_id: z.string().nullable().optional().meta({ description: "Alias for tenantId" }),
+    tags: z
+        .union([z.array(z.string()), z.string()])
+        .nullable()
+        .optional()
+        .meta({ description: "Filter by tags" }),
+    limit: laxInt
+        .nullable()
+        .optional()
+        .meta({ description: "Maximum number of results. Defaults to 5." }),
+});
+export const DeleteResearchInputSchema = z
+    .object({
+    researchId: z
+        .string()
+        .min(1)
+        .nullable()
+        .optional()
+        .meta({ description: "The UUID of the research entry to delete" }),
+    research_id: z
+        .string()
+        .min(1)
+        .nullable()
+        .optional()
+        .meta({ description: "Alias for researchId" }),
+    id: z.string().min(1).nullable().optional().meta({ description: "Alias for researchId" }),
+})
+    .refine((data) => !!(data.researchId ?? data.research_id ?? data.id), {
+    message: "One of researchId, research_id, or id must be provided",
+});
+export const GetDateTimeInputSchema = z
+    .object({})
+    .describe("No input required. Returns the current date, time, and timezone.");
+export const RefreshResearchInputSchema = z
+    .object({
+    researchId: z
+        .string()
+        .min(1)
+        .nullable()
+        .optional()
+        .meta({ description: "The UUID of the research entry to force-refresh" }),
+    research_id: z
+        .string()
+        .min(1)
+        .nullable()
+        .optional()
+        .meta({ description: "Alias for researchId" }),
+    id: z.string().min(1).nullable().optional().meta({ description: "Alias for researchId" }),
+    maxResults: laxInt
+        .nullable()
+        .optional()
+        .meta({ description: "Maximum search results to process during refresh. Defaults to 10." }),
+    max_results: laxInt.nullable().optional().meta({ description: "Alias for maxResults" }),
+})
+    .refine((data) => !!(data.researchId ?? data.research_id ?? data.id), {
+    message: "One of researchId, research_id, or id must be provided",
+});
+//# sourceMappingURL=lifecycleSchemas.js.map

package/dist/lib/schemas/lifecycleSchemas.js.map

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

package/dist/lib/schemas/researchSchemas.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod/v4";
+/** Boolean that also accepts string representations (JSON Schema compat). */
+export declare const laxBool: z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>;
+/** Integer that also accepts string representations (JSON Schema compat). */
+export declare const laxInt: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+/** Float that also accepts string representations (JSON Schema compat). */
+export declare const laxFloat: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+export declare const RmsResearchInputSchema: z.ZodObject<{
+    subject: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    topic: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    query: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    question: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    tenantId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    tenant_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    forceRefresh: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>>;
+    force_refresh: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>>;
+    maxResults: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
+    max_results: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
+    metadata: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    traceId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type RmsResearchInput = z.infer<typeof RmsResearchInputSchema>;
+//# sourceMappingURL=researchSchemas.d.ts.map

package/dist/lib/schemas/researchSchemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"researchSchemas.d.ts","sourceRoot":"","sources":["../../../src/lib/schemas/researchSchemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAW3B,6EAA6E;AAC7E,eAAO,MAAM,OAAO,kDAAqC,CAAC;AAE1D,6EAA6E;AAC7E,eAAO,MAAM,MAAM,iDAA0C,CAAC;AAE9D,2EAA2E;AAC3E,eAAO,MAAM,QAAQ,iDAAoC,CAAC;AAI1D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;iBAiE/B,CAAC;AAEL,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/lib/schemas/researchSchemas.js

@@ -0,0 +1,83 @@
+import { z } from "zod/v4";
+/* -------------------------------------------------------------------------- */
+/*  JSON Schema–safe lax types                                                */
+/*                                                                            */
+/*  These schemas avoid `.transform()` which Zod v4's `toJSONSchema()`        */
+/*  refuses to serialize. LLM string coercion happens in                      */
+/*  `coerceLifecycleInput()` BEFORE schema parsing so the proper branch       */
+/*  of each union matches.                                                    */
+/* -------------------------------------------------------------------------- */
+/** Boolean that also accepts string representations (JSON Schema compat). */
+export const laxBool = z.union([z.boolean(), z.string()]);
+/** Integer that also accepts string representations (JSON Schema compat). */
+export const laxInt = z.union([z.number().int(), z.string()]);
+/** Float that also accepts string representations (JSON Schema compat). */
+export const laxFloat = z.union([z.number(), z.string()]);
+// ── Main research tool input schema ──
+export const RmsResearchInputSchema = z
+    .object({
+    subject: z
+        .string()
+        .min(1)
+        .nullable()
+        .optional()
+        .meta({
+        title: "subject",
+        description: "The research topic or question to investigate",
+        examples: ["latest trends in AI safety", "React server components best practices"],
+    }),
+    topic: z
+        .string()
+        .min(1)
+        .nullable()
+        .optional()
+        .meta({ description: "Alias for subject — the research topic" }),
+    query: z
+        .string()
+        .min(1)
+        .nullable()
+        .optional()
+        .meta({ description: "Alias for subject — the research query" }),
+    question: z
+        .string()
+        .min(1)
+        .nullable()
+        .optional()
+        .meta({ description: "Alias for subject — the research question" }),
+    tenantId: z
+        .string()
+        .nullable()
+        .optional()
+        .meta({ description: "Optional tenant ID for multi-tenancy isolation" }),
+    tenant_id: z.string().nullable().optional().meta({ description: "Alias for tenantId" }),
+    forceRefresh: laxBool
+        .nullable()
+        .optional()
+        .meta({
+        description: "Force re-research even if cached data is fresh. Defaults to false.",
+        examples: [false, true],
+    }),
+    force_refresh: laxBool.nullable().optional().meta({ description: "Alias for forceRefresh" }),
+    maxResults: laxInt
+        .nullable()
+        .optional()
+        .meta({
+        description: "Maximum number of web search results to process. Defaults to 10.",
+        examples: [5, 10, 20],
+    }),
+    max_results: laxInt.nullable().optional().meta({ description: "Alias for maxResults" }),
+    metadata: z
+        .record(z.string(), z.unknown())
+        .nullable()
+        .optional()
+        .meta({ description: "Optional extra metadata to attach to the research entry" }),
+    traceId: z
+        .string()
+        .nullable()
+        .optional()
+        .meta({ description: "Optional trace ID for observability correlation" }),
+})
+    .refine((data) => !!(data.subject ?? data.topic ?? data.query ?? data.question), {
+    message: "At least one of subject, topic, query, or question must be provided",
+});
+//# sourceMappingURL=researchSchemas.js.map

package/dist/lib/schemas/researchSchemas.js.map

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

package/dist/lib/tools/deleteResearch.d.ts

@@ -0,0 +1,19 @@
+import type { RmsToolDeps } from "../types.js";
+/**
+ * Creates the `rms_delete_research` tool.
+ * Deletes a research entry by its UUID.
+ */
+export declare function createDeleteResearchTool(deps: RmsToolDeps): import("@langchain/core/tools").DynamicStructuredTool<import("zod/v4").ZodObject<{
+    researchId: import("zod/v4").ZodOptional<import("zod/v4").ZodNullable<import("zod/v4").ZodString>>;
+    research_id: import("zod/v4").ZodOptional<import("zod/v4").ZodNullable<import("zod/v4").ZodString>>;
+    id: import("zod/v4").ZodOptional<import("zod/v4").ZodNullable<import("zod/v4").ZodString>>;
+}, import("zod/v4/core").$strip>, {
+    researchId?: string | null | undefined;
+    research_id?: string | null | undefined;
+    id?: string | null | undefined;
+}, {
+    researchId?: string | null | undefined;
+    research_id?: string | null | undefined;
+    id?: string | null | undefined;
+}, string, unknown, "rms_delete_research">;
+//# sourceMappingURL=deleteResearch.d.ts.map

package/dist/lib/tools/deleteResearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deleteResearch.d.ts","sourceRoot":"","sources":["../../../src/lib/tools/deleteResearch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK/C;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,WAAW;;;;;;;;;;;;2CA8BzD"}

package/dist/lib/tools/deleteResearch.js

@@ -0,0 +1,37 @@
+import { tool } from "@langchain/core/tools";
+import { DeleteResearchInputSchema, coerceLifecycleInput } from "../schemas/lifecycleSchemas.js";
+import { stripNulls, normalizeInput, wrapToolResponse, getResearchOrThrow } from "../helpers.js";
+import { logError, ErrorCodes } from "../../infra/observability/tracing.js";
+/**
+ * Creates the `rms_delete_research` tool.
+ * Deletes a research entry by its UUID.
+ */
+export function createDeleteResearchTool(deps) {
+    return tool(async (rawInput) => {
+        try {
+            const input = normalizeInput(stripNulls(coerceLifecycleInput(rawInput)));
+            const researchId = input["researchId"];
+            // Verify it exists first
+            await getResearchOrThrow(deps.researchRepository, researchId);
+            await deps.researchRepository.deleteByIds([researchId]);
+            return wrapToolResponse({
+                deleted: true,
+                researchId,
+            });
+        }
+        catch (err) {
+            logError("rms_delete_research failed", {
+                errorCode: ErrorCodes.RESEARCH_NOT_FOUND,
+                error: err instanceof Error ? err.message : String(err),
+            });
+            return wrapToolResponse({
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }, {
+        name: "rms_delete_research",
+        description: "Delete a specific research entry from the cache by its UUID. The entry is permanently removed. Use this to clean up outdated or irrelevant research data.",
+        schema: DeleteResearchInputSchema,
+    });
+}
+//# sourceMappingURL=deleteResearch.js.map

package/dist/lib/tools/deleteResearch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deleteResearch.js","sourceRoot":"","sources":["../../../src/lib/tools/deleteResearch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAE7C,OAAO,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACjG,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AAE5E;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAiB;IACxD,OAAO,IAAI,CACT,KAAK,EAAE,QAAQ,EAAE,EAAE;QACjB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACzE,MAAM,UAAU,GAAG,KAAK,CAAC,YAAY,CAAW,CAAC;YACjD,yBAAyB;YACzB,MAAM,kBAAkB,CAAC,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC;YAC9D,MAAM,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;YACxD,OAAO,gBAAgB,CAAC;gBACtB,OAAO,EAAE,IAAI;gBACb,UAAU;aACX,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,4BAA4B,EAAE;gBACrC,SAAS,EAAE,UAAU,CAAC,kBAAkB;gBACxC,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC,CAAC;YACH,OAAO,gBAAgB,CAAC;gBACtB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC,CAAC;QACL,CAAC;IACH,CAAC,EACD;QACE,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EACT,2JAA2J;QAC7J,MAAM,EAAE,yBAAyB;KAClC,CACF,CAAC;AACJ,CAAC"}

package/dist/lib/tools/getDatetime.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Creates the `rms_get_datetime` tool.
+ * Returns the current date, time, and timezone — useful for agents
+ * that need to know "now" for freshness decisions.
+ */
+export declare function createGetDatetimeTool(): import("@langchain/core/tools").DynamicStructuredTool<import("zod/v4").ZodObject<{}, import("zod/v4/core").$strip>, Record<string, never>, Record<string, never>, string, unknown, "rms_get_datetime">;
+//# sourceMappingURL=getDatetime.d.ts.map

package/dist/lib/tools/getDatetime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDatetime.d.ts","sourceRoot":"","sources":["../../../src/lib/tools/getDatetime.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAgB,qBAAqB,2MAoBpC"}