@illuma-ai/agents 1.4.0-alpha.6 → 1.5.0

package/dist/esm/tools/artifacts/schema.mjs

@@ -1,79 +0,0 @@
-import { z } from 'zod';
-
-const ARTIFACT_WRITE_ACTIONS = [
-    'write',
-    'edit',
-    'verify',
-    'delete',
-];
-const CONTENT_READ_ACTIONS = ['read', 'search', 'list', 'info'];
-const artifactToolSchema = z.object({
-    action: z
-        .enum(ARTIFACT_WRITE_ACTIONS)
-        .describe('Authoring action: write (create/overwrite), edit (str_replace), verify (syntax check), delete (remove).'),
-    content_id: z
-        .string()
-        .optional()
-        .describe('ID of the artifact entry. Required for edit/verify/delete; optional for write (supply to overwrite an existing entry).'),
-    // write
-    content: z
-        .string()
-        .optional()
-        .describe('Full file content (required for write action).'),
-    name: z
-        .string()
-        .optional()
-        .describe('Filename for the new entry (required when creating). MUST include the correct file extension — the extension drives the preview template.'),
-    // edit (str_replace)
-    old_str: z
-        .string()
-        .optional()
-        .describe('Exact string to find and replace (required for edit).'),
-    new_str: z
-        .string()
-        .optional()
-        .describe('Replacement string (required for edit).'),
-    replace_all: z
-        .boolean()
-        .optional()
-        .describe('edit: when true, replaces every occurrence of old_str. When false (default) and old_str matches more than one location, the edit is refused.'),
-});
-const contentReaderSchema = z.object({
-    action: z
-        .enum(CONTENT_READ_ACTIONS)
-        .describe('Read-only action: read (lines), search (regex), list (all entries), info (metadata).'),
-    content_id: z
-        .string()
-        .optional()
-        .describe('ID of the content entry. Required for read/search/info. Omit for list.'),
-    // read pagination
-    start_line: z.number().optional().describe('1-based start line for reading.'),
-    end_line: z.number().optional().describe('1-based end line (inclusive).'),
-    // search
-    pattern: z
-        .string()
-        .optional()
-        .describe('Regex pattern (required for search).'),
-    flags: z
-        .string()
-        .optional()
-        .describe('Regex flags (e.g., "i" for case-insensitive).'),
-    context: z
-        .number()
-        .optional()
-        .describe('Lines of context around each match.'),
-    // shared pagination
-    offset: z
-        .number()
-        .optional()
-        .describe('Offset for read or search pagination.'),
-    limit: z
-        .number()
-        .optional()
-        .describe('Max lines (read) or matches (search).'),
-});
-const ARTIFACT_TOOL_NAME = 'artifact_tool';
-const CONTENT_READER_NAME = 'content_reader';
-
-export { ARTIFACT_TOOL_NAME, ARTIFACT_WRITE_ACTIONS, CONTENT_READER_NAME, CONTENT_READ_ACTIONS, artifactToolSchema, contentReaderSchema };
-//# sourceMappingURL=schema.mjs.map

package/dist/esm/tools/artifacts/schema.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema.mjs","sources":["../../../../src/tools/artifacts/schema.ts"],"sourcesContent":["import { z } from 'zod';\n\nexport const ARTIFACT_WRITE_ACTIONS = [\n  'write',\n  'edit',\n  'verify',\n  'delete',\n] as const;\nexport const CONTENT_READ_ACTIONS = ['read', 'search', 'list', 'info'] as const;\n\nexport const artifactToolSchema = z.object({\n  action: z\n    .enum(ARTIFACT_WRITE_ACTIONS)\n    .describe(\n      'Authoring action: write (create/overwrite), edit (str_replace), verify (syntax check), delete (remove).'\n    ),\n  content_id: z\n    .string()\n    .optional()\n    .describe(\n      'ID of the artifact entry. Required for edit/verify/delete; optional for write (supply to overwrite an existing entry).'\n    ),\n\n  // write\n  content: z\n    .string()\n    .optional()\n    .describe('Full file content (required for write action).'),\n  name: z\n    .string()\n    .optional()\n    .describe(\n      'Filename for the new entry (required when creating). MUST include the correct file extension — the extension drives the preview template.'\n    ),\n\n  // edit (str_replace)\n  old_str: z\n    .string()\n    .optional()\n    .describe('Exact string to find and replace (required for edit).'),\n  new_str: z\n    .string()\n    .optional()\n    .describe('Replacement string (required for edit).'),\n  replace_all: z\n    .boolean()\n    .optional()\n    .describe(\n      'edit: when true, replaces every occurrence of old_str. When false (default) and old_str matches more than one location, the edit is refused.'\n    ),\n});\n\nexport const contentReaderSchema = z.object({\n  action: z\n    .enum(CONTENT_READ_ACTIONS)\n    .describe(\n      'Read-only action: read (lines), search (regex), list (all entries), info (metadata).'\n    ),\n  content_id: z\n    .string()\n    .optional()\n    .describe(\n      'ID of the content entry. Required for read/search/info. Omit for list.'\n    ),\n\n  // read pagination\n  start_line: z.number().optional().describe('1-based start line for reading.'),\n  end_line: z.number().optional().describe('1-based end line (inclusive).'),\n\n  // search\n  pattern: z\n    .string()\n    .optional()\n    .describe('Regex pattern (required for search).'),\n  flags: z\n    .string()\n    .optional()\n    .describe('Regex flags (e.g., \"i\" for case-insensitive).'),\n  context: z\n    .number()\n    .optional()\n    .describe('Lines of context around each match.'),\n\n  // shared pagination\n  offset: z\n    .number()\n    .optional()\n    .describe('Offset for read or search pagination.'),\n  limit: z\n    .number()\n    .optional()\n    .describe('Max lines (read) or matches (search).'),\n});\n\nexport const ARTIFACT_TOOL_NAME = 'artifact_tool';\nexport const CONTENT_READER_NAME = 'content_reader';\n\nexport type ArtifactToolInput = z.infer<typeof artifactToolSchema>;\nexport type ContentReaderInput = z.infer<typeof contentReaderSchema>;\n"],"names":[],"mappings":";;AAEO,MAAM,sBAAsB,GAAG;IACpC,OAAO;IACP,MAAM;IACN,QAAQ;IACR,QAAQ;;AAEH,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM;AAE9D,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;AACzC,IAAA,MAAM,EAAE;SACL,IAAI,CAAC,sBAAsB;SAC3B,QAAQ,CACP,yGAAyG,CAC1G;AACH,IAAA,UAAU,EAAE;AACT,SAAA,MAAM;AACN,SAAA,QAAQ;SACR,QAAQ,CACP,wHAAwH,CACzH;;AAGH,IAAA,OAAO,EAAE;AACN,SAAA,MAAM;AACN,SAAA,QAAQ;SACR,QAAQ,CAAC,gDAAgD,CAAC;AAC7D,IAAA,IAAI,EAAE;AACH,SAAA,MAAM;AACN,SAAA,QAAQ;SACR,QAAQ,CACP,2IAA2I,CAC5I;;AAGH,IAAA,OAAO,EAAE;AACN,SAAA,MAAM;AACN,SAAA,QAAQ;SACR,QAAQ,CAAC,uDAAuD,CAAC;AACpE,IAAA,OAAO,EAAE;AACN,SAAA,MAAM;AACN,SAAA,QAAQ;SACR,QAAQ,CAAC,yCAAyC,CAAC;AACtD,IAAA,WAAW,EAAE;AACV,SAAA,OAAO;AACP,SAAA,QAAQ;SACR,QAAQ,CACP,8IAA8I,CAC/I;AACJ,CAAA;AAEM,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;AAC1C,IAAA,MAAM,EAAE;SACL,IAAI,CAAC,oBAAoB;SACzB,QAAQ,CACP,sFAAsF,CACvF;AACH,IAAA,UAAU,EAAE;AACT,SAAA,MAAM;AACN,SAAA,QAAQ;SACR,QAAQ,CACP,wEAAwE,CACzE;;AAGH,IAAA,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;AAC7E,IAAA,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;;AAGzE,IAAA,OAAO,EAAE;AACN,SAAA,MAAM;AACN,SAAA,QAAQ;SACR,QAAQ,CAAC,sCAAsC,CAAC;AACnD,IAAA,KAAK,EAAE;AACJ,SAAA,MAAM;AACN,SAAA,QAAQ;SACR,QAAQ,CAAC,+CAA+C,CAAC;AAC5D,IAAA,OAAO,EAAE;AACN,SAAA,MAAM;AACN,SAAA,QAAQ;SACR,QAAQ,CAAC,qCAAqC,CAAC;;AAGlD,IAAA,MAAM,EAAE;AACL,SAAA,MAAM;AACN,SAAA,QAAQ;SACR,QAAQ,CAAC,uCAAuC,CAAC;AACpD,IAAA,KAAK,EAAE;AACJ,SAAA,MAAM;AACN,SAAA,QAAQ;SACR,QAAQ,CAAC,uCAAuC,CAAC;AACrD,CAAA;AAEM,MAAM,kBAAkB,GAAG;AAC3B,MAAM,mBAAmB,GAAG;;;;"}

package/dist/esm/tools/artifacts/tool.mjs

@@ -1,213 +0,0 @@
-import { tool } from '@langchain/core/tools';
-import { artifactToolSchema, ARTIFACT_TOOL_NAME, contentReaderSchema, CONTENT_READER_NAME } from './schema.mjs';
-export { ARTIFACT_WRITE_ACTIONS, CONTENT_READ_ACTIONS } from './schema.mjs';
-
-/**
- * artifact_tool + content_reader library factories.
- *
- * The library owns the LangChain wiring (schema, description, response
- * shape) and the action dispatch; the runtime supplies a handler bundle
- * matching the `ArtifactWriteHandlers` / `ContentReadHandlers` interface.
- *
- * This keeps 800+ LOC of host-specific handler logic (S3 adapters, file
- * model CRUD, syntax checkers, line utils) out of the library while
- * still centralizing the tool surface every runtime shares.
- */
-const DEFAULT_ARTIFACT_DESCRIPTION = `Author content artifacts that render live in the host's preview panel — this tool does NOT produce downloadable files (use execute_code for those).
-
-Actions:
-- write: Create a new artifact. Write a COMPLETE file in one call. The \`name\` field MUST include the file extension — it routes the preview (.tsx, .html, .mmd, .svg, .csv, .json, .dot, .md, .drawio).
-- verify: Check an artifact for syntax errors. REQUIRED as the next step after every write/edit on code files — do not render until verify passes.
-- edit: Surgical string replacement — provide old_str (exact match) and new_str. Works on all file types.
-- delete: Remove an artifact and its backing file.
-
-Artifacts are persisted by the host. No manual save needed.`;
-const DEFAULT_CONTENT_READER_DESCRIPTION = `Read and navigate stored content — artifacts authored by artifact_tool, large tool results auto-cached by the host, uploaded file attachments, and code blocks.
-
-Read-only surface. Use write/edit tools (artifact_tool, execute_code) to mutate.
-
-Actions:
-- read: Return line ranges from a specific content_id.
-- search: Regex search across a specific content_id with paginated matches.
-- list: Enumerate every content entry currently stored.
-- info: Metadata (size, kind, creation time) for a specific content_id.`;
-/**
- * Optional content_id self-healing — if the runtime supplies a resolver,
- * we pre-resolve the ID on every action that takes one so nicknames
- * (e.g., "Dashboard") map to canonical IDs.
- */
-async function resolveContentIdIfPresent(resolver, id, scope, logger) {
-    if (!resolver || !id)
-        return id;
-    const out = await resolver.resolve(id, scope);
-    if (!out)
-        return id;
-    if (out.resolvedId !== id) {
-        logger?.debug(`[artifact] resolved "${id}" → "${out.resolvedId}"${out.resolvedName ? ` ("${out.resolvedName}")` : ''}`);
-    }
-    return out.resolvedId;
-}
-// ─── Writer tool (artifact_tool) ─────────────────────────────────────────
-function createArtifactTool(config) {
-    const { handlers, getScope, resolver, logger, descriptionOverride } = config;
-    return tool(async (rawInput, runnableConfig) => {
-        const scope = getScope(runnableConfig);
-        if (!scope) {
-            logger?.warn('[artifact_tool] no scope resolved from runnableConfig');
-            return ['Error: No conversation context available', {}];
-        }
-        const input = rawInput;
-        const resolvedContentId = await resolveContentIdIfPresent(resolver, input.content_id, scope, logger);
-        const started = Date.now();
-        try {
-            switch (input.action) {
-                case 'write': {
-                    const args = {
-                        action: 'write',
-                        content_id: resolvedContentId,
-                        content: input.content ?? '',
-                        name: input.name,
-                    };
-                    if (!args.content)
-                        return ['Error: write requires content', {}];
-                    return await handlers.write(args, scope);
-                }
-                case 'edit': {
-                    if (!resolvedContentId)
-                        return ['Error: edit requires content_id', {}];
-                    const args = {
-                        action: 'edit',
-                        content_id: resolvedContentId,
-                        old_str: input.old_str ?? '',
-                        new_str: input.new_str ?? '',
-                        replace_all: input.replace_all,
-                    };
-                    if (!args.old_str)
-                        return ['Error: edit requires old_str', {}];
-                    return await handlers.edit(args, scope);
-                }
-                case 'verify': {
-                    if (!resolvedContentId)
-                        return ['Error: verify requires content_id', {}];
-                    const args = {
-                        action: 'verify',
-                        content_id: resolvedContentId,
-                    };
-                    return await handlers.verify(args, scope);
-                }
-                case 'delete': {
-                    if (!resolvedContentId)
-                        return ['Error: delete requires content_id', {}];
-                    const args = {
-                        action: 'delete',
-                        content_id: resolvedContentId,
-                    };
-                    return await handlers.delete(args, scope);
-                }
-                default:
-                    return [
-                        `Unknown action: ${input.action}`,
-                        {},
-                    ];
-            }
-        }
-        catch (err) {
-            const e = err instanceof Error ? err : new Error(String(err));
-            logger?.error('[artifact_tool] handler threw', {
-                action: input.action,
-                contentId: resolvedContentId,
-                error: e.message,
-                elapsed: `${Date.now() - started}ms`,
-            });
-            return [`Error: ${e.message}`, {}];
-        }
-    }, {
-        name: ARTIFACT_TOOL_NAME,
-        responseFormat: 'content_and_artifact',
-        description: descriptionOverride ?? DEFAULT_ARTIFACT_DESCRIPTION,
-        schema: artifactToolSchema,
-    });
-}
-// ─── Reader tool (content_reader) ────────────────────────────────────────
-function createContentReaderTool(config) {
-    const { handlers, getScope, resolver, logger, descriptionOverride } = config;
-    return tool(async (rawInput, runnableConfig) => {
-        const scope = getScope(runnableConfig);
-        if (!scope) {
-            logger?.warn('[content_reader] no scope resolved from runnableConfig');
-            return ['Error: No conversation context available', {}];
-        }
-        const input = rawInput;
-        const resolvedContentId = await resolveContentIdIfPresent(resolver, input.content_id, scope, logger);
-        const started = Date.now();
-        try {
-            switch (input.action) {
-                case 'read': {
-                    if (!resolvedContentId)
-                        return ['Error: read requires content_id', {}];
-                    const args = {
-                        action: 'read',
-                        content_id: resolvedContentId,
-                        start_line: input.start_line,
-                        end_line: input.end_line,
-                        offset: input.offset,
-                        limit: input.limit,
-                    };
-                    return await handlers.read(args, scope);
-                }
-                case 'search': {
-                    if (!resolvedContentId)
-                        return ['Error: search requires content_id', {}];
-                    if (!input.pattern)
-                        return ['Error: search requires pattern', {}];
-                    const args = {
-                        action: 'search',
-                        content_id: resolvedContentId,
-                        pattern: input.pattern,
-                        flags: input.flags,
-                        context: input.context,
-                        offset: input.offset,
-                        limit: input.limit,
-                    };
-                    return await handlers.search(args, scope);
-                }
-                case 'list': {
-                    const args = { action: 'list' };
-                    return await handlers.list(args, scope);
-                }
-                case 'info': {
-                    if (!resolvedContentId)
-                        return ['Error: info requires content_id', {}];
-                    const args = {
-                        action: 'info',
-                        content_id: resolvedContentId,
-                    };
-                    return await handlers.info(args, scope);
-                }
-                default:
-                    return [
-                        `Unknown action: ${input.action}`,
-                        {},
-                    ];
-            }
-        }
-        catch (err) {
-            const e = err instanceof Error ? err : new Error(String(err));
-            logger?.error('[content_reader] handler threw', {
-                action: input.action,
-                contentId: resolvedContentId,
-                error: e.message,
-                elapsed: `${Date.now() - started}ms`,
-            });
-            return [`Error: ${e.message}`, {}];
-        }
-    }, {
-        name: CONTENT_READER_NAME,
-        responseFormat: 'content_and_artifact',
-        description: descriptionOverride ?? DEFAULT_CONTENT_READER_DESCRIPTION,
-        schema: contentReaderSchema,
-    });
-}
-
-export { ARTIFACT_TOOL_NAME, CONTENT_READER_NAME, createArtifactTool, createContentReaderTool };
-//# sourceMappingURL=tool.mjs.map

package/dist/esm/tools/artifacts/tool.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"tool.mjs","sources":["../../../../src/tools/artifacts/tool.ts"],"sourcesContent":["/**\n * artifact_tool + content_reader library factories.\n *\n * The library owns the LangChain wiring (schema, description, response\n * shape) and the action dispatch; the runtime supplies a handler bundle\n * matching the `ArtifactWriteHandlers` / `ContentReadHandlers` interface.\n *\n * This keeps 800+ LOC of host-specific handler logic (S3 adapters, file\n * model CRUD, syntax checkers, line utils) out of the library while\n * still centralizing the tool surface every runtime shares.\n */\n\nimport { tool, DynamicStructuredTool } from '@langchain/core/tools';\nimport {\n  artifactToolSchema,\n  contentReaderSchema,\n  ARTIFACT_TOOL_NAME,\n  CONTENT_READER_NAME,\n} from './schema';\nimport type {\n  ArtifactToolConfig,\n  ContentReaderToolConfig,\n  ArtifactToolScope,\n  ArtifactToolResult,\n  WriteArgs,\n  EditArgs,\n  VerifyArgs,\n  DeleteArgs,\n  ReadArgs,\n  SearchArgs,\n  ListArgs,\n  InfoArgs,\n  ContentIdResolver,\n} from './types';\n\nconst DEFAULT_ARTIFACT_DESCRIPTION = `Author content artifacts that render live in the host's preview panel — this tool does NOT produce downloadable files (use execute_code for those).\n\nActions:\n- write: Create a new artifact. Write a COMPLETE file in one call. The \\`name\\` field MUST include the file extension — it routes the preview (.tsx, .html, .mmd, .svg, .csv, .json, .dot, .md, .drawio).\n- verify: Check an artifact for syntax errors. REQUIRED as the next step after every write/edit on code files — do not render until verify passes.\n- edit: Surgical string replacement — provide old_str (exact match) and new_str. Works on all file types.\n- delete: Remove an artifact and its backing file.\n\nArtifacts are persisted by the host. No manual save needed.`;\n\nconst DEFAULT_CONTENT_READER_DESCRIPTION = `Read and navigate stored content — artifacts authored by artifact_tool, large tool results auto-cached by the host, uploaded file attachments, and code blocks.\n\nRead-only surface. Use write/edit tools (artifact_tool, execute_code) to mutate.\n\nActions:\n- read: Return line ranges from a specific content_id.\n- search: Regex search across a specific content_id with paginated matches.\n- list: Enumerate every content entry currently stored.\n- info: Metadata (size, kind, creation time) for a specific content_id.`;\n\n/**\n * Optional content_id self-healing — if the runtime supplies a resolver,\n * we pre-resolve the ID on every action that takes one so nicknames\n * (e.g., \"Dashboard\") map to canonical IDs.\n */\nasync function resolveContentIdIfPresent(\n  resolver: ContentIdResolver | undefined,\n  id: string | undefined,\n  scope: ArtifactToolScope,\n  logger?: { debug: (msg: string) => void }\n): Promise<string | undefined> {\n  if (!resolver || !id) return id;\n  const out = await resolver.resolve(id, scope);\n  if (!out) return id;\n  if (out.resolvedId !== id) {\n    logger?.debug(\n      `[artifact] resolved \"${id}\" → \"${out.resolvedId}\"${out.resolvedName ? ` (\"${out.resolvedName}\")` : ''}`\n    );\n  }\n  return out.resolvedId;\n}\n\n// ─── Writer tool (artifact_tool) ─────────────────────────────────────────\n\nexport function createArtifactTool(\n  config: ArtifactToolConfig\n): DynamicStructuredTool {\n  const { handlers, getScope, resolver, logger, descriptionOverride } = config;\n\n  return tool(\n    async (rawInput, runnableConfig): Promise<ArtifactToolResult> => {\n      const scope = getScope(runnableConfig);\n      if (!scope) {\n        logger?.warn('[artifact_tool] no scope resolved from runnableConfig');\n        return ['Error: No conversation context available', {}];\n      }\n\n      const input = rawInput as {\n        action: 'write' | 'edit' | 'verify' | 'delete';\n        content_id?: string;\n        content?: string;\n        name?: string;\n        old_str?: string;\n        new_str?: string;\n        replace_all?: boolean;\n      };\n\n      const resolvedContentId = await resolveContentIdIfPresent(\n        resolver,\n        input.content_id,\n        scope,\n        logger\n      );\n\n      const started = Date.now();\n      try {\n        switch (input.action) {\n          case 'write': {\n            const args: WriteArgs = {\n              action: 'write',\n              content_id: resolvedContentId,\n              content: input.content ?? '',\n              name: input.name,\n            };\n            if (!args.content) return ['Error: write requires content', {}];\n            return await handlers.write(args, scope);\n          }\n          case 'edit': {\n            if (!resolvedContentId)\n              return ['Error: edit requires content_id', {}];\n            const args: EditArgs = {\n              action: 'edit',\n              content_id: resolvedContentId,\n              old_str: input.old_str ?? '',\n              new_str: input.new_str ?? '',\n              replace_all: input.replace_all,\n            };\n            if (!args.old_str) return ['Error: edit requires old_str', {}];\n            return await handlers.edit(args, scope);\n          }\n          case 'verify': {\n            if (!resolvedContentId)\n              return ['Error: verify requires content_id', {}];\n            const args: VerifyArgs = {\n              action: 'verify',\n              content_id: resolvedContentId,\n            };\n            return await handlers.verify(args, scope);\n          }\n          case 'delete': {\n            if (!resolvedContentId)\n              return ['Error: delete requires content_id', {}];\n            const args: DeleteArgs = {\n              action: 'delete',\n              content_id: resolvedContentId,\n            };\n            return await handlers.delete(args, scope);\n          }\n          default:\n            return [\n              `Unknown action: ${(input as { action: string }).action}`,\n              {},\n            ];\n        }\n      } catch (err) {\n        const e = err instanceof Error ? err : new Error(String(err));\n        logger?.error('[artifact_tool] handler threw', {\n          action: input.action,\n          contentId: resolvedContentId,\n          error: e.message,\n          elapsed: `${Date.now() - started}ms`,\n        });\n        return [`Error: ${e.message}`, {}];\n      }\n    },\n    {\n      name: ARTIFACT_TOOL_NAME,\n      responseFormat: 'content_and_artifact',\n      description: descriptionOverride ?? DEFAULT_ARTIFACT_DESCRIPTION,\n      schema: artifactToolSchema,\n    }\n  );\n}\n\n// ─── Reader tool (content_reader) ────────────────────────────────────────\n\nexport function createContentReaderTool(\n  config: ContentReaderToolConfig\n): DynamicStructuredTool {\n  const { handlers, getScope, resolver, logger, descriptionOverride } = config;\n\n  return tool(\n    async (rawInput, runnableConfig): Promise<ArtifactToolResult> => {\n      const scope = getScope(runnableConfig);\n      if (!scope) {\n        logger?.warn('[content_reader] no scope resolved from runnableConfig');\n        return ['Error: No conversation context available', {}];\n      }\n\n      const input = rawInput as {\n        action: 'read' | 'search' | 'list' | 'info';\n        content_id?: string;\n        start_line?: number;\n        end_line?: number;\n        pattern?: string;\n        flags?: string;\n        context?: number;\n        offset?: number;\n        limit?: number;\n      };\n\n      const resolvedContentId = await resolveContentIdIfPresent(\n        resolver,\n        input.content_id,\n        scope,\n        logger\n      );\n\n      const started = Date.now();\n      try {\n        switch (input.action) {\n          case 'read': {\n            if (!resolvedContentId)\n              return ['Error: read requires content_id', {}];\n            const args: ReadArgs = {\n              action: 'read',\n              content_id: resolvedContentId,\n              start_line: input.start_line,\n              end_line: input.end_line,\n              offset: input.offset,\n              limit: input.limit,\n            };\n            return await handlers.read(args, scope);\n          }\n          case 'search': {\n            if (!resolvedContentId)\n              return ['Error: search requires content_id', {}];\n            if (!input.pattern) return ['Error: search requires pattern', {}];\n            const args: SearchArgs = {\n              action: 'search',\n              content_id: resolvedContentId,\n              pattern: input.pattern,\n              flags: input.flags,\n              context: input.context,\n              offset: input.offset,\n              limit: input.limit,\n            };\n            return await handlers.search(args, scope);\n          }\n          case 'list': {\n            const args: ListArgs = { action: 'list' };\n            return await handlers.list(args, scope);\n          }\n          case 'info': {\n            if (!resolvedContentId)\n              return ['Error: info requires content_id', {}];\n            const args: InfoArgs = {\n              action: 'info',\n              content_id: resolvedContentId,\n            };\n            return await handlers.info(args, scope);\n          }\n          default:\n            return [\n              `Unknown action: ${(input as { action: string }).action}`,\n              {},\n            ];\n        }\n      } catch (err) {\n        const e = err instanceof Error ? err : new Error(String(err));\n        logger?.error('[content_reader] handler threw', {\n          action: input.action,\n          contentId: resolvedContentId,\n          error: e.message,\n          elapsed: `${Date.now() - started}ms`,\n        });\n        return [`Error: ${e.message}`, {}];\n      }\n    },\n    {\n      name: CONTENT_READER_NAME,\n      responseFormat: 'content_and_artifact',\n      description: descriptionOverride ?? DEFAULT_CONTENT_READER_DESCRIPTION,\n      schema: contentReaderSchema,\n    }\n  );\n}\n\nexport {\n  ARTIFACT_TOOL_NAME,\n  CONTENT_READER_NAME,\n  ARTIFACT_WRITE_ACTIONS,\n  CONTENT_READ_ACTIONS,\n} from './schema';\n"],"names":[],"mappings":";;;;AAAA;;;;;;;;;;AAUG;AAyBH,MAAM,4BAA4B,GAAG,CAAA;;;;;;;;4DAQuB;AAE5D,MAAM,kCAAkC,GAAG,CAAA;;;;;;;;wEAQ6B;AAExE;;;;AAIG;AACH,eAAe,yBAAyB,CACtC,QAAuC,EACvC,EAAsB,EACtB,KAAwB,EACxB,MAAyC,EAAA;AAEzC,IAAA,IAAI,CAAC,QAAQ,IAAI,CAAC,EAAE;AAAE,QAAA,OAAO,EAAE;IAC/B,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC;AAC7C,IAAA,IAAI,CAAC,GAAG;AAAE,QAAA,OAAO,EAAE;AACnB,IAAA,IAAI,GAAG,CAAC,UAAU,KAAK,EAAE,EAAE;QACzB,MAAM,EAAE,KAAK,CACX,CAAA,qBAAA,EAAwB,EAAE,CAAA,KAAA,EAAQ,GAAG,CAAC,UAAU,CAAA,CAAA,EAAI,GAAG,CAAC,YAAY,GAAG,CAAA,GAAA,EAAM,GAAG,CAAC,YAAY,CAAA,EAAA,CAAI,GAAG,EAAE,CAAA,CAAE,CACzG;IACH;IACA,OAAO,GAAG,CAAC,UAAU;AACvB;AAEA;AAEM,SAAU,kBAAkB,CAChC,MAA0B,EAAA;AAE1B,IAAA,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM;IAE5E,OAAO,IAAI,CACT,OAAO,QAAQ,EAAE,cAAc,KAAiC;AAC9D,QAAA,MAAM,KAAK,GAAG,QAAQ,CAAC,cAAc,CAAC;QACtC,IAAI,CAAC,KAAK,EAAE;AACV,YAAA,MAAM,EAAE,IAAI,CAAC,uDAAuD,CAAC;AACrE,YAAA,OAAO,CAAC,0CAA0C,EAAE,EAAE,CAAC;QACzD;QAEA,MAAM,KAAK,GAAG,QAQb;AAED,QAAA,MAAM,iBAAiB,GAAG,MAAM,yBAAyB,CACvD,QAAQ,EACR,KAAK,CAAC,UAAU,EAChB,KAAK,EACL,MAAM,CACP;AAED,QAAA,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE;AAC1B,QAAA,IAAI;AACF,YAAA,QAAQ,KAAK,CAAC,MAAM;gBAClB,KAAK,OAAO,EAAE;AACZ,oBAAA,MAAM,IAAI,GAAc;AACtB,wBAAA,MAAM,EAAE,OAAO;AACf,wBAAA,UAAU,EAAE,iBAAiB;AAC7B,wBAAA,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE;wBAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;qBACjB;oBACD,IAAI,CAAC,IAAI,CAAC,OAAO;AAAE,wBAAA,OAAO,CAAC,+BAA+B,EAAE,EAAE,CAAC;oBAC/D,OAAO,MAAM,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC;gBAC1C;gBACA,KAAK,MAAM,EAAE;AACX,oBAAA,IAAI,CAAC,iBAAiB;AACpB,wBAAA,OAAO,CAAC,iCAAiC,EAAE,EAAE,CAAC;AAChD,oBAAA,MAAM,IAAI,GAAa;AACrB,wBAAA,MAAM,EAAE,MAAM;AACd,wBAAA,UAAU,EAAE,iBAAiB;AAC7B,wBAAA,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE;AAC5B,wBAAA,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE;wBAC5B,WAAW,EAAE,KAAK,CAAC,WAAW;qBAC/B;oBACD,IAAI,CAAC,IAAI,CAAC,OAAO;AAAE,wBAAA,OAAO,CAAC,8BAA8B,EAAE,EAAE,CAAC;oBAC9D,OAAO,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC;gBACzC;gBACA,KAAK,QAAQ,EAAE;AACb,oBAAA,IAAI,CAAC,iBAAiB;AACpB,wBAAA,OAAO,CAAC,mCAAmC,EAAE,EAAE,CAAC;AAClD,oBAAA,MAAM,IAAI,GAAe;AACvB,wBAAA,MAAM,EAAE,QAAQ;AAChB,wBAAA,UAAU,EAAE,iBAAiB;qBAC9B;oBACD,OAAO,MAAM,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC;gBAC3C;gBACA,KAAK,QAAQ,EAAE;AACb,oBAAA,IAAI,CAAC,iBAAiB;AACpB,wBAAA,OAAO,CAAC,mCAAmC,EAAE,EAAE,CAAC;AAClD,oBAAA,MAAM,IAAI,GAAe;AACvB,wBAAA,MAAM,EAAE,QAAQ;AAChB,wBAAA,UAAU,EAAE,iBAAiB;qBAC9B;oBACD,OAAO,MAAM,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC;gBAC3C;AACA,gBAAA;oBACE,OAAO;wBACL,CAAA,gBAAA,EAAoB,KAA4B,CAAC,MAAM,CAAA,CAAE;wBACzD,EAAE;qBACH;;QAEP;QAAE,OAAO,GAAG,EAAE;YACZ,MAAM,CAAC,GAAG,GAAG,YAAY,KAAK,GAAG,GAAG,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC7D,YAAA,MAAM,EAAE,KAAK,CAAC,+BAA+B,EAAE;gBAC7C,MAAM,EAAE,KAAK,CAAC,MAAM;AACpB,gBAAA,SAAS,EAAE,iBAAiB;gBAC5B,KAAK,EAAE,CAAC,CAAC,OAAO;gBAChB,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAA,EAAA,CAAI;AACrC,aAAA,CAAC;YACF,OAAO,CAAC,UAAU,CAAC,CAAC,OAAO,CAAA,CAAE,EAAE,EAAE,CAAC;QACpC;AACF,IAAA,CAAC,EACD;AACE,QAAA,IAAI,EAAE,kBAAkB;AACxB,QAAA,cAAc,EAAE,sBAAsB;QACtC,WAAW,EAAE,mBAAmB,IAAI,4BAA4B;AAChE,QAAA,MAAM,EAAE,kBAAkB;AAC3B,KAAA,CACF;AACH;AAEA;AAEM,SAAU,uBAAuB,CACrC,MAA+B,EAAA;AAE/B,IAAA,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM;IAE5E,OAAO,IAAI,CACT,OAAO,QAAQ,EAAE,cAAc,KAAiC;AAC9D,QAAA,MAAM,KAAK,GAAG,QAAQ,CAAC,cAAc,CAAC;QACtC,IAAI,CAAC,KAAK,EAAE;AACV,YAAA,MAAM,EAAE,IAAI,CAAC,wDAAwD,CAAC;AACtE,YAAA,OAAO,CAAC,0CAA0C,EAAE,EAAE,CAAC;QACzD;QAEA,MAAM,KAAK,GAAG,QAUb;AAED,QAAA,MAAM,iBAAiB,GAAG,MAAM,yBAAyB,CACvD,QAAQ,EACR,KAAK,CAAC,UAAU,EAChB,KAAK,EACL,MAAM,CACP;AAED,QAAA,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE;AAC1B,QAAA,IAAI;AACF,YAAA,QAAQ,KAAK,CAAC,MAAM;gBAClB,KAAK,MAAM,EAAE;AACX,oBAAA,IAAI,CAAC,iBAAiB;AACpB,wBAAA,OAAO,CAAC,iCAAiC,EAAE,EAAE,CAAC;AAChD,oBAAA,MAAM,IAAI,GAAa;AACrB,wBAAA,MAAM,EAAE,MAAM;AACd,wBAAA,UAAU,EAAE,iBAAiB;wBAC7B,UAAU,EAAE,KAAK,CAAC,UAAU;wBAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;wBACxB,MAAM,EAAE,KAAK,CAAC,MAAM;wBACpB,KAAK,EAAE,KAAK,CAAC,KAAK;qBACnB;oBACD,OAAO,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC;gBACzC;gBACA,KAAK,QAAQ,EAAE;AACb,oBAAA,IAAI,CAAC,iBAAiB;AACpB,wBAAA,OAAO,CAAC,mCAAmC,EAAE,EAAE,CAAC;oBAClD,IAAI,CAAC,KAAK,CAAC,OAAO;AAAE,wBAAA,OAAO,CAAC,gCAAgC,EAAE,EAAE,CAAC;AACjE,oBAAA,MAAM,IAAI,GAAe;AACvB,wBAAA,MAAM,EAAE,QAAQ;AAChB,wBAAA,UAAU,EAAE,iBAAiB;wBAC7B,OAAO,EAAE,KAAK,CAAC,OAAO;wBACtB,KAAK,EAAE,KAAK,CAAC,KAAK;wBAClB,OAAO,EAAE,KAAK,CAAC,OAAO;wBACtB,MAAM,EAAE,KAAK,CAAC,MAAM;wBACpB,KAAK,EAAE,KAAK,CAAC,KAAK;qBACnB;oBACD,OAAO,MAAM,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC;gBAC3C;gBACA,KAAK,MAAM,EAAE;AACX,oBAAA,MAAM,IAAI,GAAa,EAAE,MAAM,EAAE,MAAM,EAAE;oBACzC,OAAO,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC;gBACzC;gBACA,KAAK,MAAM,EAAE;AACX,oBAAA,IAAI,CAAC,iBAAiB;AACpB,wBAAA,OAAO,CAAC,iCAAiC,EAAE,EAAE,CAAC;AAChD,oBAAA,MAAM,IAAI,GAAa;AACrB,wBAAA,MAAM,EAAE,MAAM;AACd,wBAAA,UAAU,EAAE,iBAAiB;qBAC9B;oBACD,OAAO,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC;gBACzC;AACA,gBAAA;oBACE,OAAO;wBACL,CAAA,gBAAA,EAAoB,KAA4B,CAAC,MAAM,CAAA,CAAE;wBACzD,EAAE;qBACH;;QAEP;QAAE,OAAO,GAAG,EAAE;YACZ,MAAM,CAAC,GAAG,GAAG,YAAY,KAAK,GAAG,GAAG,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC7D,YAAA,MAAM,EAAE,KAAK,CAAC,gCAAgC,EAAE;gBAC9C,MAAM,EAAE,KAAK,CAAC,MAAM;AACpB,gBAAA,SAAS,EAAE,iBAAiB;gBAC5B,KAAK,EAAE,CAAC,CAAC,OAAO;gBAChB,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAA,EAAA,CAAI;AACrC,aAAA,CAAC;YACF,OAAO,CAAC,UAAU,CAAC,CAAC,OAAO,CAAA,CAAE,EAAE,EAAE,CAAC;QACpC;AACF,IAAA,CAAC,EACD;AACE,QAAA,IAAI,EAAE,mBAAmB;AACzB,QAAA,cAAc,EAAE,sBAAsB;QACtC,WAAW,EAAE,mBAAmB,IAAI,kCAAkC;AACtE,QAAA,MAAM,EAAE,mBAAmB;AAC5B,KAAA,CACF;AACH;;;;"}

package/dist/esm/tools/fileSearch/formatter.mjs

@@ -1,90 +0,0 @@
-/**
- * Default result formatters.
- *
- * - `plainTextFormatter`: CLI / A2A / generic output. No citation anchors.
- * - `citationAnchorFormatter`: ranger-style `\ue202turn0fileN` anchors with
- *   a monotonic `sourceOffset` so multi-call turns stay globally unique.
- *
- * Runtimes can supply their own `FileSearchResultFormatter` to override.
- */
-const plainTextFormatter = {
-    format(chunks, { files: _files }) {
-        if (chunks.length === 0) {
-            return { message: 'No relevant results found in the available files.' };
-        }
-        const body = chunks
-            .map((c) => {
-            const page = getPage(c);
-            const rel = (1 - c.distance).toFixed(4);
-            return (`File: ${c.filename}` +
-                (page != null ? `\nPage: ${page}` : '') +
-                `\nRelevance: ${rel}\nContent: ${c.page_content}\n`);
-        })
-            .join('\n---\n');
-        const sources = chunks.map((c) => ({
-            type: 'file',
-            fileId: c.file_id,
-            content: c.page_content,
-            fileName: c.filename,
-            relevance: 1 - c.distance,
-            pages: getPage(c) != null ? [getPage(c)] : [],
-        }));
-        return { message: body, artifact: { file_search: { sources } } };
-    },
-};
-function createCitationAnchorFormatter(opts = {}) {
-    const toolName = opts.toolName ?? 'file_search';
-    const getOffset = opts.getSourceOffset ?? (() => 0);
-    const advance = opts.advanceSourceOffset ?? ((_by) => { });
-    return {
-        format(chunks) {
-            if (chunks.length === 0) {
-                return {
-                    message: 'No results found or errors occurred while searching the files.',
-                };
-            }
-            const base = getOffset();
-            const body = chunks
-                .map((c, i) => {
-                const globalIndex = base + i;
-                const page = getPage(c);
-                const rel = (1 - c.distance).toFixed(4);
-                return (`[Source ${globalIndex}] File: ${c.filename} | Anchor: \\ue202turn0file${globalIndex}` +
-                    (page != null ? ` | Page: ${page}` : '') +
-                    ` | Relevance: ${rel}\nContent: ${c.page_content}\n` +
-                    `↑ Cite this source using: \\ue202turn0file${globalIndex}`);
-            })
-                .join('\n---\n');
-            const sources = chunks.map((c) => ({
-                type: 'file',
-                fileId: c.file_id,
-                content: c.page_content,
-                fileName: c.filename,
-                relevance: 1 - c.distance,
-                pages: getPage(c) != null ? [getPage(c)] : [],
-                pageRelevance: getPage(c) != null ? { [getPage(c)]: 1 - c.distance } : {},
-            }));
-            advance(chunks.length);
-            return {
-                message: body,
-                artifact: { [toolName]: { sources, fileCitations: true } },
-            };
-        },
-    };
-}
-/** Extract a 1-indexed page number from the chunk metadata, or null. */
-function getPage(chunk) {
-    const raw = chunk.metadata?.page ??
-        chunk.metadata?.page_number ??
-        null;
-    if (raw == null)
-        return null;
-    const parsed = typeof raw === 'number' ? raw : parseInt(String(raw), 10);
-    if (Number.isNaN(parsed) || parsed < 0)
-        return null;
-    // rag_api stores 0-indexed; display is 1-indexed
-    return parsed + 1;
-}
-
-export { createCitationAnchorFormatter, plainTextFormatter };
-//# sourceMappingURL=formatter.mjs.map

package/dist/esm/tools/fileSearch/formatter.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"formatter.mjs","sources":["../../../../src/tools/fileSearch/formatter.ts"],"sourcesContent":["/**\n * Default result formatters.\n *\n * - `plainTextFormatter`: CLI / A2A / generic output. No citation anchors.\n * - `citationAnchorFormatter`: ranger-style `\\ue202turn0fileN` anchors with\n *   a monotonic `sourceOffset` so multi-call turns stay globally unique.\n *\n * Runtimes can supply their own `FileSearchResultFormatter` to override.\n */\n\nimport type {\n  FileSearchResultFormatter,\n  FileSearchFile,\n  RagChunk,\n} from './types';\n\ntype AnnotatedChunk = RagChunk & {\n  filename: string;\n  isCurrentMessage: boolean;\n};\n\nexport const plainTextFormatter: FileSearchResultFormatter = {\n  format(chunks, { files: _files }) {\n    if (chunks.length === 0) {\n      return { message: 'No relevant results found in the available files.' };\n    }\n    const body = chunks\n      .map((c) => {\n        const page = getPage(c);\n        const rel = (1 - c.distance).toFixed(4);\n        return (\n          `File: ${c.filename}` +\n          (page != null ? `\\nPage: ${page}` : '') +\n          `\\nRelevance: ${rel}\\nContent: ${c.page_content}\\n`\n        );\n      })\n      .join('\\n---\\n');\n\n    const sources = chunks.map((c) => ({\n      type: 'file' as const,\n      fileId: c.file_id,\n      content: c.page_content,\n      fileName: c.filename,\n      relevance: 1 - c.distance,\n      pages: getPage(c) != null ? [getPage(c) as number] : [],\n    }));\n\n    return { message: body, artifact: { file_search: { sources } } };\n  },\n};\n\nexport interface CitationAnchorFormatterOptions {\n  /** Tool name used in the `file_search` artifact wrapper. Defaults to `'file_search'`. */\n  toolName?: string;\n  /**\n   * Monotonic counter for source indices within a turn. Pass the SAME\n   * function to the formatter across multiple calls in the same turn so\n   * anchors stay globally unique.\n   */\n  getSourceOffset?: () => number;\n  /** Called after formatting to advance the offset. */\n  advanceSourceOffset?: (by: number) => void;\n}\n\nexport function createCitationAnchorFormatter(\n  opts: CitationAnchorFormatterOptions = {}\n): FileSearchResultFormatter {\n  const toolName = opts.toolName ?? 'file_search';\n  const getOffset = opts.getSourceOffset ?? ((): number => 0);\n  const advance = opts.advanceSourceOffset ?? ((_by: number): void => {});\n\n  return {\n    format(chunks): { message: string; artifact?: unknown } {\n      if (chunks.length === 0) {\n        return {\n          message:\n            'No results found or errors occurred while searching the files.',\n        };\n      }\n      const base = getOffset();\n      const body = chunks\n        .map((c, i) => {\n          const globalIndex = base + i;\n          const page = getPage(c);\n          const rel = (1 - c.distance).toFixed(4);\n          return (\n            `[Source ${globalIndex}] File: ${c.filename} | Anchor: \\\\ue202turn0file${globalIndex}` +\n            (page != null ? ` | Page: ${page}` : '') +\n            ` | Relevance: ${rel}\\nContent: ${c.page_content}\\n` +\n            `↑ Cite this source using: \\\\ue202turn0file${globalIndex}`\n          );\n        })\n        .join('\\n---\\n');\n\n      const sources = chunks.map((c) => ({\n        type: 'file' as const,\n        fileId: c.file_id,\n        content: c.page_content,\n        fileName: c.filename,\n        relevance: 1 - c.distance,\n        pages: getPage(c) != null ? [getPage(c) as number] : [],\n        pageRelevance:\n          getPage(c) != null ? { [getPage(c) as number]: 1 - c.distance } : {},\n      }));\n\n      advance(chunks.length);\n      return {\n        message: body,\n        artifact: { [toolName]: { sources, fileCitations: true } },\n      };\n    },\n  };\n}\n\n/** Extract a 1-indexed page number from the chunk metadata, or null. */\nfunction getPage(chunk: AnnotatedChunk | RagChunk): number | null {\n  const raw =\n    (chunk.metadata?.page as unknown) ??\n    (chunk.metadata?.page_number as unknown) ??\n    null;\n  if (raw == null) return null;\n  const parsed = typeof raw === 'number' ? raw : parseInt(String(raw), 10);\n  if (Number.isNaN(parsed) || parsed < 0) return null;\n  // rag_api stores 0-indexed; display is 1-indexed\n  return parsed + 1;\n}\n\n// Re-export so consumers only import from the formatter module.\nexport type { FileSearchResultFormatter, FileSearchFile, RagChunk };\n"],"names":[],"mappings":"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"}

package/dist/esm/tools/fileSearch/ragClient.mjs

@@ -1,98 +0,0 @@
-import fetch from 'node-fetch';
-import { getEnvironmentVariable } from '@langchain/core/utils/env';
-
-/**
- * Default HTTP RAG client. Posts to `${baseUrl}/query` with the shape
- * rag_api expects (`{ file_id, query, k, entity_id? }`). Runtimes that
- * use a different vector backend implement their own `RagClient`.
- *
- * Auth is runtime-provided per call (via `authHeaders` on the params) so
- * short-lived tokens can be minted per request without the client
- * caching stale credentials.
- */
-const RAG_API_URL_ENV = 'RAG_API_URL';
-/** Resolve base URL at call time so env-var changes propagate. */
-function getRagBaseUrl(override) {
-    const url = override ?? getEnvironmentVariable(RAG_API_URL_ENV) ?? '';
-    if (!url) {
-        throw new Error(`file_search: ${RAG_API_URL_ENV} is not configured. ` +
-            `Set the env var or pass baseUrl to HttpRagClient.`);
-    }
-    return url.replace(/\/$/, '');
-}
-class HttpRagClient {
-    baseUrlOverride;
-    defaultHeaders;
-    defaultTimeoutMs;
-    logger;
-    constructor(opts = {}) {
-        this.baseUrlOverride = opts.baseUrl;
-        this.defaultHeaders = opts.defaultHeaders ?? {};
-        this.defaultTimeoutMs = opts.defaultTimeoutMs ?? 15_000;
-        this.logger = opts.logger;
-    }
-    async query(params) {
-        const baseUrl = getRagBaseUrl(this.baseUrlOverride);
-        const url = `${baseUrl}/query`;
-        const body = {
-            file_id: params.file_id,
-            query: params.query,
-            k: params.k ?? 10,
-        };
-        if (params.entity_id)
-            body.entity_id = params.entity_id;
-        if (params.scope)
-            body.scope = params.scope;
-        const headers = {
-            'Content-Type': 'application/json',
-            ...this.defaultHeaders,
-            ...(params.authHeaders ?? {}),
-        };
-        const timeoutMs = params.timeoutMs ?? this.defaultTimeoutMs;
-        const controller = typeof AbortController !== 'undefined' ? new AbortController() : null;
-        const timer = controller
-            ? setTimeout(() => controller.abort(), timeoutMs)
-            : null;
-        this.logger?.debug('[file_search] RAG query', {
-            url,
-            file_id: params.file_id,
-            k: body.k,
-        });
-        try {
-            const res = await fetch(url, {
-                method: 'POST',
-                headers,
-                body: JSON.stringify(body),
-                signal: controller?.signal,
-            });
-            if (!res.ok) {
-                const text = await res.text().catch(() => '');
-                throw new Error(`RAG query failed: ${res.status} ${res.statusText} — ${text.slice(0, 200)}`);
-            }
-            const json = (await res.json());
-            return this.normalize(params.file_id, json);
-        }
-        finally {
-            if (timer)
-                clearTimeout(timer);
-        }
-    }
-    /** Convert rag_api's tuple format into the library's normalized shape. */
-    normalize(file_id, resp) {
-        if (!Array.isArray(resp)) {
-            this.logger?.warn('[file_search] RAG response not an array', { resp });
-            return [];
-        }
-        return resp
-            .filter((row) => Array.isArray(row) && row.length === 2)
-            .map(([doc, distance]) => ({
-            file_id: doc.metadata?.file_id ?? file_id,
-            page_content: doc.page_content ?? '',
-            distance: typeof distance === 'number' ? distance : 1,
-            metadata: doc.metadata,
-        }));
-    }
-}
-
-export { HttpRagClient, RAG_API_URL_ENV, getRagBaseUrl };
-//# sourceMappingURL=ragClient.mjs.map

package/dist/esm/tools/fileSearch/ragClient.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"ragClient.mjs","sources":["../../../../src/tools/fileSearch/ragClient.ts"],"sourcesContent":["/**\n * Default HTTP RAG client. Posts to `${baseUrl}/query` with the shape\n * rag_api expects (`{ file_id, query, k, entity_id? }`). Runtimes that\n * use a different vector backend implement their own `RagClient`.\n *\n * Auth is runtime-provided per call (via `authHeaders` on the params) so\n * short-lived tokens can be minted per request without the client\n * caching stale credentials.\n */\n\nimport fetch from 'node-fetch';\nimport { getEnvironmentVariable } from '@langchain/core/utils/env';\nimport type {\n  RagClient,\n  RagQueryParams,\n  RagChunk,\n  FileSearchToolLogger,\n} from './types';\n\nexport const RAG_API_URL_ENV = 'RAG_API_URL';\n\n/** Resolve base URL at call time so env-var changes propagate. */\nexport function getRagBaseUrl(override?: string): string {\n  const url = override ?? getEnvironmentVariable(RAG_API_URL_ENV) ?? '';\n  if (!url) {\n    throw new Error(\n      `file_search: ${RAG_API_URL_ENV} is not configured. ` +\n        `Set the env var or pass baseUrl to HttpRagClient.`\n    );\n  }\n  return url.replace(/\\/$/, '');\n}\n\nexport interface HttpRagClientOptions {\n  /** Base URL of the RAG service (no trailing slash). Falls back to env. */\n  baseUrl?: string;\n  /** Default headers sent on every request (e.g., a static API key). */\n  defaultHeaders?: Record<string, string>;\n  /** Default timeout if params don't override. Default 15_000. */\n  defaultTimeoutMs?: number;\n  logger?: FileSearchToolLogger;\n}\n\n/**\n * Expected rag_api response shape: `[[{ page_content, metadata }, distance], ...]`\n * — an array of [doc, score] tuples. Normalized here into `RagChunk[]`.\n */\ntype RagApiResponse = Array<\n  [\n    {\n      page_content: string;\n      metadata?: Record<string, unknown>;\n    },\n    number,\n  ]\n>;\n\nexport class HttpRagClient implements RagClient {\n  private readonly baseUrlOverride?: string;\n  private readonly defaultHeaders: Record<string, string>;\n  private readonly defaultTimeoutMs: number;\n  private readonly logger?: FileSearchToolLogger;\n\n  constructor(opts: HttpRagClientOptions = {}) {\n    this.baseUrlOverride = opts.baseUrl;\n    this.defaultHeaders = opts.defaultHeaders ?? {};\n    this.defaultTimeoutMs = opts.defaultTimeoutMs ?? 15_000;\n    this.logger = opts.logger;\n  }\n\n  async query(params: RagQueryParams): Promise<RagChunk[]> {\n    const baseUrl = getRagBaseUrl(this.baseUrlOverride);\n    const url = `${baseUrl}/query`;\n\n    const body: Record<string, unknown> = {\n      file_id: params.file_id,\n      query: params.query,\n      k: params.k ?? 10,\n    };\n    if (params.entity_id) body.entity_id = params.entity_id;\n    if (params.scope) body.scope = params.scope;\n\n    const headers: Record<string, string> = {\n      'Content-Type': 'application/json',\n      ...this.defaultHeaders,\n      ...(params.authHeaders ?? {}),\n    };\n\n    const timeoutMs = params.timeoutMs ?? this.defaultTimeoutMs;\n    const controller =\n      typeof AbortController !== 'undefined' ? new AbortController() : null;\n    const timer = controller\n      ? setTimeout(() => controller.abort(), timeoutMs)\n      : null;\n\n    this.logger?.debug('[file_search] RAG query', {\n      url,\n      file_id: params.file_id,\n      k: body.k,\n    });\n\n    try {\n      const res = await fetch(url, {\n        method: 'POST',\n        headers,\n        body: JSON.stringify(body),\n        signal: controller?.signal as unknown as undefined,\n      });\n      if (!res.ok) {\n        const text = await res.text().catch(() => '');\n        throw new Error(\n          `RAG query failed: ${res.status} ${res.statusText} — ${text.slice(0, 200)}`\n        );\n      }\n      const json = (await res.json()) as RagApiResponse;\n      return this.normalize(params.file_id, json);\n    } finally {\n      if (timer) clearTimeout(timer);\n    }\n  }\n\n  /** Convert rag_api's tuple format into the library's normalized shape. */\n  private normalize(file_id: string, resp: RagApiResponse): RagChunk[] {\n    if (!Array.isArray(resp)) {\n      this.logger?.warn('[file_search] RAG response not an array', { resp });\n      return [];\n    }\n    return resp\n      .filter((row) => Array.isArray(row) && row.length === 2)\n      .map(([doc, distance]) => ({\n        file_id: (doc.metadata?.file_id as string | undefined) ?? file_id,\n        page_content: doc.page_content ?? '',\n        distance: typeof distance === 'number' ? distance : 1,\n        metadata: doc.metadata,\n      }));\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/tools/fileSearch/schema.mjs

@@ -1,15 +0,0 @@
-import { z } from 'zod';
-
-const fileSearchInputSchema = z.object({
-    query: z
-        .string()
-        .describe("A natural language query to search for relevant information in the files. Be SPECIFIC and TARGETED — use keywords for the specific section or topic you need. For comprehensive tasks (summaries, overviews), call this tool multiple times with different targeted queries (e.g., 'introduction', 'methodology', 'results', 'conclusions') rather than one broad query."),
-    target_files: z
-        .array(z.string())
-        .optional()
-        .describe('Optional list of filenames (or partial names) to limit the search to. When provided, only files whose name contains one of these strings will be searched. Use this to avoid searching irrelevant files. Omit to search all available files.'),
-});
-const FileSearchToolName = 'file_search';
-
-export { FileSearchToolName, fileSearchInputSchema };
-//# sourceMappingURL=schema.mjs.map

package/dist/esm/tools/fileSearch/schema.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"schema.mjs","sources":["../../../../src/tools/fileSearch/schema.ts"],"sourcesContent":["import { z } from 'zod';\n\nexport const fileSearchInputSchema = z.object({\n  query: z\n    .string()\n    .describe(\n      \"A natural language query to search for relevant information in the files. Be SPECIFIC and TARGETED — use keywords for the specific section or topic you need. For comprehensive tasks (summaries, overviews), call this tool multiple times with different targeted queries (e.g., 'introduction', 'methodology', 'results', 'conclusions') rather than one broad query.\"\n    ),\n  target_files: z\n    .array(z.string())\n    .optional()\n    .describe(\n      'Optional list of filenames (or partial names) to limit the search to. When provided, only files whose name contains one of these strings will be searched. Use this to avoid searching irrelevant files. Omit to search all available files.'\n    ),\n});\n\nexport type FileSearchInput = z.infer<typeof fileSearchInputSchema>;\n\nexport const FileSearchToolName = 'file_search';\n"],"names":[],"mappings":";;AAEO,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;AAC5C,IAAA,KAAK,EAAE;AACJ,SAAA,MAAM;SACN,QAAQ,CACP,0WAA0W,CAC3W;AACH,IAAA,YAAY,EAAE;AACX,SAAA,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE;AAChB,SAAA,QAAQ;SACR,QAAQ,CACP,8OAA8O,CAC/O;AACJ,CAAA;AAIM,MAAM,kBAAkB,GAAG;;;;"}