@orq-ai/node 3.8.4 → 3.8.5

package/packages/orq-rc/src/funcs/evalsRagasContextRecall.ts

@@ -0,0 +1,177 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { OrqCore } from "../core.js";
+import { encodeJSON } from "../lib/encodings.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { OrqError } from "../models/errors/orqerror.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Run Context Recall Evaluator
+ */
+export function evalsRagasContextRecall(
+  client: OrqCore,
+  request?: operations.EvalsRagasContextRecallRequestBody | undefined,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    operations.EvalsRagasContextRecallResponseBody,
+    | errors.EvalsRagasContextRecallResponseBody
+    | errors.EvalsRagasContextRecallEvalsResponseBody
+    | OrqError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: OrqCore,
+  request?: operations.EvalsRagasContextRecallRequestBody | undefined,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      operations.EvalsRagasContextRecallResponseBody,
+      | errors.EvalsRagasContextRecallResponseBody
+      | errors.EvalsRagasContextRecallEvalsResponseBody
+      | OrqError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      operations.EvalsRagasContextRecallRequestBody$outboundSchema.optional()
+        .parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = payload === undefined
+    ? null
+    : encodeJSON("body", payload, { explode: true });
+
+  const path = pathToFunc("/v2/evaluators/ragas_context_recall")();
+
+  const headers = new Headers(compactMap({
+    "Content-Type": "application/json",
+    Accept: "application/json",
+  }));
+
+  const secConfig = await extractSecurity(client._options.apiKey);
+  const securityInput = secConfig == null ? {} : { apiKey: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "EvalsRagasContextRecall",
+    oAuth2Scopes: [],
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.apiKey,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "POST",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    body: body,
+    userAgent: client._options.userAgent,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || 600000,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req = requestRes.value;
+
+  const doResult = await client._do(req, {
+    context,
+    errorCodes: ["404", "4XX", "500", "5XX"],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
+  const [result] = await M.match<
+    operations.EvalsRagasContextRecallResponseBody,
+    | errors.EvalsRagasContextRecallResponseBody
+    | errors.EvalsRagasContextRecallEvalsResponseBody
+    | OrqError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, operations.EvalsRagasContextRecallResponseBody$inboundSchema),
+    M.jsonErr(404, errors.EvalsRagasContextRecallResponseBody$inboundSchema),
+    M.jsonErr(
+      500,
+      errors.EvalsRagasContextRecallEvalsResponseBody$inboundSchema,
+    ),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, req, { extraFields: responseFields });
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/packages/orq-rc/src/funcs/evalsRagasNoiseSensitivity.ts

@@ -0,0 +1,180 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { OrqCore } from "../core.js";
+import { encodeJSON } from "../lib/encodings.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.js";
+import { OrqError } from "../models/errors/orqerror.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Run Noise Sensitivity Evaluator
+ */
+export function evalsRagasNoiseSensitivity(
+  client: OrqCore,
+  request?: operations.EvalsRagasNoiseSensitivityRequestBody | undefined,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    operations.EvalsRagasNoiseSensitivityResponseBody,
+    | errors.EvalsRagasNoiseSensitivityResponseBody
+    | errors.EvalsRagasNoiseSensitivityEvalsResponseBody
+    | OrqError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: OrqCore,
+  request?: operations.EvalsRagasNoiseSensitivityRequestBody | undefined,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      operations.EvalsRagasNoiseSensitivityResponseBody,
+      | errors.EvalsRagasNoiseSensitivityResponseBody
+      | errors.EvalsRagasNoiseSensitivityEvalsResponseBody
+      | OrqError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      operations.EvalsRagasNoiseSensitivityRequestBody$outboundSchema.optional()
+        .parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = payload === undefined
+    ? null
+    : encodeJSON("body", payload, { explode: true });
+
+  const path = pathToFunc("/v2/evaluators/ragas_noise_sensitivity")();
+
+  const headers = new Headers(compactMap({
+    "Content-Type": "application/json",
+    Accept: "application/json",
+  }));
+
+  const secConfig = await extractSecurity(client._options.apiKey);
+  const securityInput = secConfig == null ? {} : { apiKey: secConfig };
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "EvalsRagasNoiseSensitivity",
+    oAuth2Scopes: [],
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.apiKey,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "POST",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    body: body,
+    userAgent: client._options.userAgent,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || 600000,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req = requestRes.value;
+
+  const doResult = await client._do(req, {
+    context,
+    errorCodes: ["404", "4XX", "500", "5XX"],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const responseFields = {
+    HttpMeta: { Response: response, Request: req },
+  };
+
+  const [result] = await M.match<
+    operations.EvalsRagasNoiseSensitivityResponseBody,
+    | errors.EvalsRagasNoiseSensitivityResponseBody
+    | errors.EvalsRagasNoiseSensitivityEvalsResponseBody
+    | OrqError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(
+      200,
+      operations.EvalsRagasNoiseSensitivityResponseBody$inboundSchema,
+    ),
+    M.jsonErr(404, errors.EvalsRagasNoiseSensitivityResponseBody$inboundSchema),
+    M.jsonErr(
+      500,
+      errors.EvalsRagasNoiseSensitivityEvalsResponseBody$inboundSchema,
+    ),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, req, { extraFields: responseFields });
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/packages/orq-rc/src/funcs/{knowledgeCreate.ts → knowledgeChunkText.ts}

@@ -25,15 +25,18 @@ import { APICall, APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
 
 /**
- * Create a knowledge
+ * Chunk text content using various strategies
+ *
+ * @remarks
+ * Split large text documents into smaller, manageable chunks using different chunking strategies optimized for RAG (Retrieval-Augmented Generation) workflows. This endpoint supports multiple chunking algorithms including token-based, sentence-based, recursive, semantic, and specialized strategies.
  */
-export function knowledgeCreate(
+export function knowledgeChunkText(
   client: OrqCore,
-  request: operations.CreateKnowledgeRequestBody,
+  request: operations.ChunkTextChunkingRequest,
   options?: RequestOptions,
 ): APIPromise<
   Result<
-    operations.CreateKnowledgeResponseBody,
+    operations.ChunkTextResponseBody,
     | OrqError
     | ResponseValidationError
     | ConnectionError
@@ -53,12 +56,12 @@ export function knowledgeCreate(
 
 async function $do(
   client: OrqCore,
-  request: operations.CreateKnowledgeRequestBody,
+  request: operations.ChunkTextChunkingRequest,
   options?: RequestOptions,
 ): Promise<
   [
     Result<
-      operations.CreateKnowledgeResponseBody,
+      operations.ChunkTextResponseBody,
       | OrqError
       | ResponseValidationError
       | ConnectionError
@@ -73,8 +76,7 @@ async function $do(
 > {
   const parsed = safeParse(
     request,
-    (value) =>
-      operations.CreateKnowledgeRequestBody$outboundSchema.parse(value),
+    (value) => operations.ChunkTextChunkingRequest$outboundSchema.parse(value),
     "Input validation failed",
   );
   if (!parsed.ok) {
@@ -97,7 +99,7 @@ async function $do(
   const context = {
     options: client._options,
     baseURL: options?.serverURL ?? client._baseURL ?? "",
-    operationID: "CreateKnowledge",
+    operationID: "ChunkText",
     oAuth2Scopes: [],
 
     resolvedSecurity: requestSecurity,
@@ -136,7 +138,7 @@ async function $do(
   const response = doResult.value;
 
   const [result] = await M.match<
-    operations.CreateKnowledgeResponseBody,
+    operations.ChunkTextResponseBody,
     | OrqError
     | ResponseValidationError
     | ConnectionError
@@ -146,7 +148,7 @@ async function $do(
     | UnexpectedClientError
     | SDKValidationError
   >(
-    M.json(200, operations.CreateKnowledgeResponseBody$inboundSchema),
+    M.json(200, operations.ChunkTextResponseBody$inboundSchema),
     M.fail("4XX"),
     M.fail("5XX"),
   )(response, req);

package/packages/orq-rc/src/lib/config.ts

@@ -68,7 +68,7 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "2.0",
-  sdkVersion: "3.8.0-rc.36",
-  genVersion: "2.630.9",
-  userAgent: "speakeasy-sdk/typescript 3.8.0-rc.36 2.630.9 2.0 @orq-ai/node",
+  sdkVersion: "3.9.0-rc.1",
+  genVersion: "2.632.2",
+  userAgent: "speakeasy-sdk/typescript 3.9.0-rc.1 2.632.2 2.0 @orq-ai/node",
 } as const;

package/packages/orq-rc/src/mcp-server/mcp-server.ts

@@ -19,7 +19,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "3.8.0-rc.36",
+    currentVersion: "3.9.0-rc.1",
   },
 });
 

package/packages/orq-rc/src/mcp-server/server.ts

@@ -62,11 +62,14 @@ import { tool$evalsLocalization } from "./tools/evalsLocalization.js";
 import { tool$evalsPii } from "./tools/evalsPii.js";
 import { tool$evalsRagasCoherence } from "./tools/evalsRagasCoherence.js";
 import { tool$evalsRagasConciseness } from "./tools/evalsRagasConciseness.js";
+import { tool$evalsRagasContextEntitiesRecall } from "./tools/evalsRagasContextEntitiesRecall.js";
 import { tool$evalsRagasContextPrecision } from "./tools/evalsRagasContextPrecision.js";
+import { tool$evalsRagasContextRecall } from "./tools/evalsRagasContextRecall.js";
 import { tool$evalsRagasCorrectness } from "./tools/evalsRagasCorrectness.js";
 import { tool$evalsRagasFaithfulness } from "./tools/evalsRagasFaithfulness.js";
 import { tool$evalsRagasHarmfulness } from "./tools/evalsRagasHarmfulness.js";
 import { tool$evalsRagasMaliciousness } from "./tools/evalsRagasMaliciousness.js";
+import { tool$evalsRagasNoiseSensitivity } from "./tools/evalsRagasNoiseSensitivity.js";
 import { tool$evalsRagasResponseRelevancy } from "./tools/evalsRagasResponseRelevancy.js";
 import { tool$evalsRagasSummarization } from "./tools/evalsRagasSummarization.js";
 import { tool$evalsSentimentClassification } from "./tools/evalsSentimentClassification.js";
@@ -80,7 +83,7 @@ import { tool$filesCreate } from "./tools/filesCreate.js";
 import { tool$filesDelete } from "./tools/filesDelete.js";
 import { tool$filesGet } from "./tools/filesGet.js";
 import { tool$filesList } from "./tools/filesList.js";
-import { tool$knowledgeCreate } from "./tools/knowledgeCreate.js";
+import { tool$knowledgeChunkText } from "./tools/knowledgeChunkText.js";
 import { tool$knowledgeCreateChunks } from "./tools/knowledgeCreateChunks.js";
 import { tool$knowledgeCreateDatasource } from "./tools/knowledgeCreateDatasource.js";
 import { tool$knowledgeDelete } from "./tools/knowledgeDelete.js";
@@ -118,7 +121,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "Orq",
-    version: "3.8.0-rc.36",
+    version: "3.9.0-rc.1",
   });
 
   const client = new OrqCore({
@@ -187,7 +190,6 @@ export function createMCPServer(deps: {
   tool(tool$datasetsDeleteDatapoint);
   tool(tool$datasetsClear);
   tool(tool$knowledgeList);
-  tool(tool$knowledgeCreate);
   tool(tool$knowledgeRetrieve);
   tool(tool$knowledgeUpdate);
   tool(tool$knowledgeDelete);
@@ -202,6 +204,7 @@ export function createMCPServer(deps: {
   tool(tool$knowledgeUpdateChunk);
   tool(tool$knowledgeDeleteChunk);
   tool(tool$knowledgeRetrieveChunk);
+  tool(tool$knowledgeChunkText);
   tool(tool$evalsAll);
   tool(tool$evalsCreate);
   tool(tool$evalsUpdate);
@@ -234,10 +237,13 @@ export function createMCPServer(deps: {
   tool(tool$evalsRagasCoherence);
   tool(tool$evalsRagasConciseness);
   tool(tool$evalsRagasContextPrecision);
+  tool(tool$evalsRagasContextRecall);
+  tool(tool$evalsRagasContextEntitiesRecall);
   tool(tool$evalsRagasCorrectness);
   tool(tool$evalsRagasFaithfulness);
   tool(tool$evalsRagasHarmfulness);
   tool(tool$evalsRagasMaliciousness);
+  tool(tool$evalsRagasNoiseSensitivity);
   tool(tool$evalsRagasResponseRelevancy);
   tool(tool$evalsRagasSummarization);
   tool(tool$evalsInvoke);

package/packages/orq-rc/src/mcp-server/tools/evalsRagasContextEntitiesRecall.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { evalsRagasContextEntitiesRecall } from "../../funcs/evalsRagasContextEntitiesRecall.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.EvalsRagasContextEntitiesRecallRequestBody$inboundSchema
+    .optional(),
+};
+
+export const tool$evalsRagasContextEntitiesRecall: ToolDefinition<typeof args> =
+  {
+    name: "evals-ragas-context-entities-recall",
+    description: `Run Context Entities Recall Evaluator`,
+    args,
+    tool: async (client, args, ctx) => {
+      const [result, apiCall] = await evalsRagasContextEntitiesRecall(
+        client,
+        args.request,
+        { fetchOptions: { signal: ctx.signal } },
+      ).$inspect();
+
+      if (!result.ok) {
+        return {
+          content: [{ type: "text", text: result.error.message }],
+          isError: true,
+        };
+      }
+
+      const value = result.value;
+
+      return formatResult(value, apiCall);
+    },
+  };

package/packages/orq-rc/src/mcp-server/tools/{knowledgeCreate.ts → evalsRagasContextRecall.ts}

@@ -2,20 +2,21 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
-import { knowledgeCreate } from "../../funcs/knowledgeCreate.js";
+import { evalsRagasContextRecall } from "../../funcs/evalsRagasContextRecall.js";
 import * as operations from "../../models/operations/index.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: operations.CreateKnowledgeRequestBody$inboundSchema,
+  request: operations.EvalsRagasContextRecallRequestBody$inboundSchema
+    .optional(),
 };
 
-export const tool$knowledgeCreate: ToolDefinition<typeof args> = {
-  name: "knowledge-create",
-  description: `Create a knowledge`,
+export const tool$evalsRagasContextRecall: ToolDefinition<typeof args> = {
+  name: "evals-ragas-context-recall",
+  description: `Run Context Recall Evaluator`,
   args,
   tool: async (client, args, ctx) => {
-    const [result, apiCall] = await knowledgeCreate(
+    const [result, apiCall] = await evalsRagasContextRecall(
       client,
       args.request,
       { fetchOptions: { signal: ctx.signal } },

package/packages/orq-rc/src/mcp-server/tools/evalsRagasNoiseSensitivity.ts

@@ -0,0 +1,36 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { evalsRagasNoiseSensitivity } from "../../funcs/evalsRagasNoiseSensitivity.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.EvalsRagasNoiseSensitivityRequestBody$inboundSchema
+    .optional(),
+};
+
+export const tool$evalsRagasNoiseSensitivity: ToolDefinition<typeof args> = {
+  name: "evals-ragas-noise-sensitivity",
+  description: `Run Noise Sensitivity Evaluator`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await evalsRagasNoiseSensitivity(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/packages/orq-rc/src/mcp-server/tools/knowledgeChunkText.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { knowledgeChunkText } from "../../funcs/knowledgeChunkText.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.ChunkTextChunkingRequest$inboundSchema,
+};
+
+export const tool$knowledgeChunkText: ToolDefinition<typeof args> = {
+  name: "knowledge-chunk-text",
+  description: `Chunk text content using various strategies
+
+Split large text documents into smaller, manageable chunks using different chunking strategies optimized for RAG (Retrieval-Augmented Generation) workflows. This endpoint supports multiple chunking algorithms including token-based, sentence-based, recursive, semantic, and specialized strategies.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await knowledgeChunkText(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};